CallbackDisk

Create and manage virtual disk drives from your Windows applications

CBDisk.InstallDriver method

Filter:

Pascal    C++ (Lib)    C++ (VCL)    C++ (.NET)    C#    VB.NET   

CBDisk     See also    

Overview

Installs the driver into the system

Declaration

[Pascal]
    class procedure InstallDriver( VirtualDiskDriverFileName : WideString; GUID : string; var RebootNeeded : boolean);

[C++ (Lib)]
    static void InstallDriver( unsigned short* VirtualDiskDriverFileName, const char * GUID, bool *RebootNeeded);

[C++ (VCL)]
    static void __fastcall InstallDriver( WideString VirtualDiskDriverFileName, const char * GUID, bool RebootNeeded);

[C++ (.NET)]
    static void InstallDriver( String* VirtualDiskDriverFileName, String* GUID, bool &RebootNeeded);

[C#]
    static void InstallDriver( string VirtualDiskDriverFileName, string GUID, ref bool RebootNeeded)

[VB.NET]
    Shared Sub InstallDriver( ByVal VirtualDiskDriverFileName As String, ByVal GUID As String, ByRef RebootNeeded As Boolean)

Parameters

  • VirtualDiskDriverFileName - the fully qualified name of the virtual block device driver (cbdisk.sys).
  • GUID - the GUID string that identifies installation of the driver by your application
  • RebootNeeded - On return this parameter specifies if system restart is necessary for driver installation to be successful.

Description

Use this function to install the driver to the system. Once installed, the driver is loaded during system startup. GUID is used to distinguish between installations of the driver made by different applications and to prevent the situation when the driver is installed by two applications and further deinstallation of one of them removes the driver.

Read more about installing and uninstalling the drivers.

Install the correct drivers:
On 64-bit systems you must install 64-bit drivers. 32-bit drivers won't work there. If your application is 32-bit, you need to determine what driver set to install. To do this you can use one of the listed methods:

  • Use IsWow64Process() WinAPI function. Note, that this function appeared only in Windows XP so you need to use GetProcAddress() WinAPI function to dynamically obtain the function pointer.
  • Check existence of %WINDIR%\SysWOW64 folder
  • Check ProgramW6432 environment variable

See also

UninstallDriver    

Back to top