项目作者: tmcdos

项目描述 :
Replacement (GUI + windows service) for ImDisk Toolkit - by using Arsenal Image Mounter as a driver for RAM-disks.
高级语言: Pascal
项目地址: git://github.com/tmcdos/ramdisk.git
创建时间: 2021-01-25T07:10:20Z
项目社区:https://github.com/tmcdos/ramdisk

开源协议:MIT License

下载


GUI + background service for the Arsenal Virtual RAM-disk driver

This project was born out of necessity. I have been using ImDisk Toolkit for years without any issues.
I particularly liked the ability to preload content to the RAM-disk from a local directory and synchronize the RAM-disk back on shutdown.
However, I started meeting issues when some newer software applications refused to work with my ImDisk-powered RAM-disk.
One easy to reproduce case is if you install Chrome 86+ and then try to install any Chrome extension - you will get a popup window with an error message

  1. ERR_CANT_FIND_TEMP_FOLDER

The underlying reason for the error is that ImDisk driver works in a special mode (Direct-IO) which bypasses Windows Volume Manager.
This leads to a problem with the Win32 API function GetFinalPathNameByHandle - you can read the discussions at

The author of ImDisk drver created Arsenal driver which works in the normal SCSI miniport mode and is visible to the Windows Volume Manager.
He provides a console utility to create/remove RAM-disk(s) but no Windows service tool that will create a RAM-disk on boot - and certainly nothing similar to the ImDisk Toolkit that I was used to (and probably many other users).
The console utility is also dependent on the ImDisk CPL applet - which I did not quite like (from a developer’s point of view).

So I decided to create a GUI for configuring the parameters of the RAM-disk, plus a Windows service that will create the desired RAM-disk on boot and persist it on shutdown.
Of course, I did some research before deciding to start the development - there were other free and commercial RAM-disk tools working as SCSI miniport drivers
but they either did not have the additional features of ImDisk Toolkit or they required a VHD image for preloading/persisting the RAM-disk contents
(and I preferred the usage of native filesystem instead of VHD image).

It took me about a week to extract the relevant code from the AIM (Arsenal Image Mounter) console utility and translate it from C++ to Objec Pascal.
After a lot of debugging and trials/errors I succeeded - and successfully replaced ImDisk Toolkit with my tools.
I have to admit that I was in a hurry and just needed a working solution - there were no attempts to make the code more robust or to implement complex features (like regex support in the list of folders excluded from synchronization at shutdown).

The code is provided “AS IS” in the hope that it will be useful to others. Testing was done only on Win7 x64 - most probably it will not work on XP.
The code requires Admin privileges and the Arsenal driver - which can be downloaded from its official repository.
Thanks to user lazychris2000 here is a short instruction how to install the Arsenal driver:

Hassle-free (automatic) way

  1. c:
  2. cd \arsenal\cli\x64
  3. aim_ll.exe --install ..\..
  • you should get something similar to the following
  1. Detected Windows kernel version 10.0.19045.
  2. Platform code: 'Win10'. Using port driver storport.sys.
  3. Reading inf file...
  4. Creating device object...
  5. Installing driver for device...
  6. Finished successfully.

Manual way

  • download https://github.com/ArsenalRecon/Arsenal-Image-Mounter/raw/master/DriverSetup/DriverFiles.zip
  • extract the archive into some folder, for example c:\arsenal
  • using Windows Explorer, open the appropriate subfolder - e.g. Win8 or Win8.1 or Win10 or perhaps Win7
  • point your mouse over phdskmnt.inf file in the given subfolder and click the right mouse button to open the context menu
  • from this context menu, choose the item Install and the Arsenal driver will be installed. You should see it in the Device Manager as Arsenal Image Mounter under the group Storage controllers

You will need Delphi 7 and TNT-Unicode in order to compile the source code of RamDiskUI - or you can simply download the binary release.
All pull requests are welcome.

Explanation of the registry values

The RAM-disk UI (not the Arsenal driver) creates several registry values which are then picked up by the RAM-disk service (not in real-time unfortunately - only on start or restart of the service).
They are created under [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ArsenalRamDisk] and are explained below:

  • DiskSize is the size in bytes
  • DriveLetter is obvious
  • LoadContent is path to a folder whose contents will be pre-loaded in the RAM-disk at startup
  • ExcludeFolders is StringList (lines delimited with CRLF) which specifies which folder names from the RAM-disk won’t be saved on shutdown in the folder specified by LoadContent. I usually create numeric folders in my RAM-disk for my daily projects - but I don’t want them to be persisted on disk because I can pull them with Git every morning.
  • UseTempFolder whether to create TEMP folder on RAM-disk and point the OS to this temp folder
  • SyncContent whether to save RAM-disk content on shutdown to the folder specified by LoadContent
  • DeleteOld whether to delete those files and folders from LoadContent which are not present on the RAM-disk on shutdown (meaningful only when SyncContent is TRUE)

Here is an example from my PC:

  1. Windows Registry Editor Version 5.00
  2. [HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\services\ArsenalRamDisk]
  3. "DiskSize"="17179869184"
  4. "DriveLetter"="Z"
  5. "LoadContent"="D:\\Setup\\RAM_disk"
  6. "ExcludeFolders"="chrome
  7. opera
  8. phpstorm
  9. stoplight
  10. _
  11. 0
  12. 1
  13. 2
  14. 3
  15. 4
  16. 5
  17. 6
  18. 7
  19. 8
  20. 9"
  21. "UseTempFolder"=dword:00000001
  22. "SyncContent"=dword:00000001
  23. "DeleteOld"=dword:00000001
  24. "Type"=dword:00000010
  25. "Start"=dword:00000002
  26. "ErrorControl"=dword:00000001
  27. "ImagePath"=hex(2):44,00,3a,00,5c,00,53,00,4f,00,55,00,52,00,43,00,45,00,5c,00,\
  28. 44,00,45,00,4c,00,46,00,49,00,5c,00,52,00,41,00,4d,00,64,00,69,00,73,00,6b,\
  29. 00,5c,00,52,00,61,00,6d,00,53,00,65,00,72,00,76,00,69,00,63,00,65,00,2e,00,\
  30. 65,00,78,00,65,00,00,00
  31. "DisplayName"="Arsenal RAM-disk"
  32. "WOW64"=dword:00000001
  33. "ObjectName"="LocalSystem"
  34. "Description"="Arsenal RAM-disk"

LICENSE

MIT License

Copyright (c) 2021 tmcdos

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the “Software”), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.