 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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 DRVENABLEDATAstructure with the driver version number and calling addresses of functions supported by the driver.
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 DRVENABLEDATAstructure. If the structure is larger than expected, extra members should be left unmodified.
- pded
- Pointer to a
DRVENABLEDATAstructure. The GDI 0-initializes
cjbytes 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 DrvEnablePDEVfunction is called before enabling hardware, such as a display.
This function is required for graphics drivers.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004