DRVENABLEDATA 结构 (winddi.h)
DRVENABLEDATA 结构包含指向 DRVFN 结构数组的指针,以及基于 NT 的操作系统的图形 DDI 版本号。
语法
typedef struct tagDRVENABLEDATA {
ULONG iDriverVersion;
ULONG c;
DRVFN *pdrvfn;
} DRVENABLEDATA, *PDRVENABLEDATA;
成员
iDriverVersion
指定驱动程序针对的基于 NT 的操作系统的图形 DDI 版本号。 此成员可以设置为以下值之一:
值 | 操作系统版本 |
---|---|
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 |
有关详细信息,请参阅备注部分。
c
指定 pdrvfn 成员指向的缓冲区中的 DRVFN 结构数。
pdrvfn
指向包含 DRVFN 结构数组的缓冲区的指针。
注解
若要在这些基于 NT 的操作系统版本上运行,必须按如下所示设置 iDriverVersion 成员:
Windows 版本 | iDriverVersion 的值 |
---|---|
Windows NT 4.0 | iDriverVersion == DDI_DRIVER_VERSION_NT4 |
Windows NT 4.0 SP3 | <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_SP3 |
Windows 2000 | <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5 |
Windows XP | <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01 |
Windows XP SP1 | <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01_SP1 |
如表所示,如果 iDriverVersion 设置为 DDI_DRIVER_VERSION_NT4,驱动程序可以在这些操作系统版本上运行,但如果 iDriverVersion 设置为 DDI_DRIVER_VERSION_NT5_01,驱动程序只能在 Windows XP 和更高版本的操作系统上运行。
注意 如果驱动程序实现的 DrvXxx 图形 DDI 并非在所有版本的 Windows 中都受支持,则驱动程序在不支持该图形 DDI 的 Windows 版本上运行时,无法为该图形 DDI 指定 DRVFN 条目。 如果驱动程序为此类图形 DDI 指定 DRVFN 条目,Windows 将拒绝该驱动程序。 permedia2 示例演示如何为不同版本的 Windows 指定不同的 DRVFN 结构。
要求
要求 | 值 |
---|---|
Header | winddi.h (包括 Winddi.h) |