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 和更新版本的操作系統上執行。
注意 如果驅動程式實作所有 Windows 版本不支援的 DrvXxx 圖形 DDI,則驅動程式無法在不支援的 Windows 版本上執行時,為該圖形 DDI 指定 DRVFN 專案。 如果驅動程式確實指定這類圖形 DDI 的DRVFN專案,Windows 將會拒絕驅動程式。 permedia2 範例示範如何為不同版本的 Windows 指定不同的DRVFN結構。
規格需求
需求 | 值 |
---|---|
標頭 | winddi.h (包括 Winddi.h) |