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 構造体を指定する方法を示しています。
要件
| 要件 | 値 |
|---|---|
| Header | winddi.h (Winddi.h を含む) |