DrvEnableDriver

This function is the initial driver entry point exported by the driver DLL. It fills a DRVENABLEDATA structure with the driver version number and calling addresses of functions supported by the driver.

Syntax

BOOL DrvEnableDriver( IN ULONG iEngineVersion, IN ULONG cj,
OUT DRVENABLEDATA *pded );

Parameters

iEngineVersion

Specifies the DDI version number that the GDI was written for. DDI_DRIVER_VERSION is always the current version; drivers should use this manifest constant, declared in the Winddi.h header file.

cj

Specifies the size, in bytes, of the DRVENABLEDATA structure. If the structure is larger than expected, extra members should be left unmodified.

pded

Pointer to a DRVENABLEDATA structure. The GDI 0-initializes cj bytes before the call. The driver fills in its own data.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

One-time initializations, such as allocating semaphores, can be performed by this function. The driver should wait until the DrvEnablePDEV function is called before enabling hardware, such as a display.

This function is required for graphics drivers.