DrvEnableDriver 函数 (winddi.h)

项目
03/13/2024

DrvEnableDriver 函数是由驱动程序 DLL 导出的初始驱动程序入口点。它使用驱动程序的图形 DDI 版本号和驱动程序支持的所有图形 DDI 函数的调用地址填充 DRVENABLEDATA 结构。

语法

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

参数

iEngineVersion

标识当前正在运行的 GDI 版本。

cj

pded 所指向的结构的大小（以字节为单位）。如果结构大于预期，应使额外的成员未修改。

[in] pded

指向 DRVENABLEDATA 结构的指针。 GDI 在调用前对 cj 字节进行零初始化。驱动程序将填充其自己的数据。

返回值

如果启用了指定的驱动程序，则返回值为 TRUE 。否则，它为 FALSE，并记录错误代码。

注解

DrvEnableDriver 必须在所有图形驱动程序中实现。如果使用 Windows 驱动程序工具包 (WDK) 生成工具，并将 TARGETTYPE 设置为 GDI_DRIVER (请参阅生成打印机图形 DLL) ，则必须将此函数命名为 DrvEnableDriver。这是唯一必须按名称访问的显示驱动程序函数。所有其他显示驱动程序函数通过函数指针进行访问;因此，本文档中将其名称显示为伪名称。

此函数也可以执行一次性初始化，例如分配信号量。驱动程序应等到调用 DrvEnablePDEV 后再启用硬件（如显示器）。

使用 iEngineVersion 中提供的值执行版本检查时，驱动程序应使用 winddi.h 中定义的相应 DDI_DRIVER_VERSION_Xxx 常量 () 下表所示。驱动程序几乎绝不应仅仅为了平等而检查，因为操作系统的新版本和 Service Pack 版本将在将来发布。有关详细信息，请参阅 DRVENABLEDATA。

值	操作系统版本
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1