Share via

DrvEnableDriver

  • Article

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.

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 Values

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

OS Versions: Windows CE 1.0 and later.
Header: Winddi.h.
Link Library: Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_perm3_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, or Ddi_tvia5_lib.lib.

See Also

Display Drivers | DRVENABLEDATA | DrvEnablePDEV | GPEEnableDriver

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.