DrvEnableDriver (Windows Embedded CE 6.0)

1/6/2010

This function is the initial driver entry point exported by the driver DLL for devices that link directly to GWES, such as display drivers and printer drivers. It fills a DRVENABLEDATA structure with the driver version number and calling addresses of functions supported by the driver.

Syntax

BOOL APIENTRY DrvEnableDriver(
  ULONG iEngineVersion,
  ULONG cj,
  DRVENABLEDATA* pded,
  PENGCALLBACKS pEngCallbacks
);

Parameters

• iEngineVersion
  [in] DDI version number that the graphics device interface (GDI) was written for. DDI_DRIVER_VERSION is always the current version; drivers should use this manifest constant, declared in Winddi.h.

• cj
  [in] Size, in bytes, of the DRVENABLEDATA structure. If the structure is larger than expected, do not modify the extra members.

• pded
  [out] Pointer to a DRVENABLEDATA structure. The GDI zero-initializes cj bytes before the call. The driver fills in its own data.

• pEngCallbacks
  [in] Structure containing function pointers to the GDI helper functions for display drivers. This is passed from GDI through DrvEnableDriver to GPEEnableDriver. It allows the display driver to obtain information from GDI.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

This function is required for graphics drivers.

You can perform one-time initializations, such as allocating semaphores, with this function. The driver should wait until the DrvEnablePDEV function executes before enabling hardware, such as a display.

Requirements

See Also

Reference

Display Driver Functions
DRVENABLEDATA
DrvEnablePDEV
GPEEnableDriver

Other Resources

Display Drivers