InstallDriver

BB FlashBack SDK: FBRecorder

InstallDriver

Description

Attempts to install the screen capture driver on the PC.

Syntax

[C#/C++]
public: long InstallDriver()

[VB.NET]
Public Function InstallDriver() As Integer

Return values

The return value is formatted as follows.

High order word:

Value	Meaning
SUCCESS_SUCCESS = 0	Successfully installed
SUCCESS_REBOOT_NEEDED = 1	Successfully installed, but PC needs to be rebooted for the driver to be fully operational.
SUCCESS_NOREBOOT_NEEDED = 2	Successfully installed and PC does not require reboot.
FAILURE = 3	Install failed.
INCOMPATIBLE_DRIVER_ERROR = 4096	Software that is known to be incompatible with the capture driver has been detected on this PC. The capture driver has therefore not been installed. See note below for more details.

Low order word:

Value	Meaning
ERROR_UNKNOWN = -1
ERROR_NOERROR = 0
ERROR_NOADMINRIGHTS = 1	Administrator rights are required for capture driver installation, and the current login does not have these rights.
ERROR_NOUNSIGNEDDRV_POLICY = 2	The current domain has a policy defined that prevents the installation of unsigned drivers, and this has prevented installation. The capture driver is signed for Windows 2000 and XP, but not for Windows 2003 - users need to explicitly approve the installation of the driver during the install process.
ERROR_UNKNOWN = 4
ERROR_EXTRACTFILES = 8	The driver files could not be extracted into the current folder. They need to be extracted prior to being copied into the Windows system folder.
ERROR_RUNONCE_SETUP = 16	The PC needs to be rebooted to complete the install process.
DRIVER_INSTALLED = 32	The driver files could not be copied into the Windows system32/drivers folder.
REGISTRY_ERROR = 512	The registry could not be read.

Remarks

Administrative access rights are required to install the driver. An alternative method of installing the driver, that can be more easily used at application install-time is via FlashbackDriverInstaller.exe. See Installing the Capture Driver on End-User PCs for details.

Call the CanDriverBeInstalled method to determine if the screen capture driver may be installed on the system.

Read the IsDriverInstalled property or use the CheckDriver method to determine the status of the capture driver - whether it is installed or not and whether a reboot is required to complete an installation or uninstallation.

Note: we have discovered that a specific 3rd party display driver is incompatible with the capture driver (and other 'mirror' drivers), causing severe system instability. See Software Incompatible with the capture driver for more details.