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)

另请参阅

DRVFN

DrvEnableDriver