D3DADAPTER_IDENTIFIER9構造体
アダプターを識別する情報が含まれます。
構文
typedef struct D3DADAPTER_IDENTIFIER9 {
char Driver[MAX_DEVICE_IDENTIFIER_STRING];
char Description[MAX_DEVICE_IDENTIFIER_STRING];
char DeviceName[32];
#ifdef _WIN32
LARGE_INTEGER DriverVersion;
#else
DWORD DriverVersionLowPart;
DWORD DriverVersionHighPart;
#endif
DWORD VendorId;
DWORD DeviceId;
DWORD SubSysId;
DWORD Revision;
GUID DeviceIdentifier;
DWORD WHQLLevel;
} D3DADAPTER_IDENTIFIER9, *LPD3DADAPTER_IDENTIFIER9;
メンバー
-
[ドライバー]
-
型: char
-
ユーザーへのプレゼンテーションに使用されます。 多くの異なる文字列が異なるベンダーの同じデバイスとドライバーに関連付けられている可能性があるため、これは特定のドライバーを識別するために使用しないでください。
-
説明
-
型: char
-
ユーザーへのプレゼンテーションに使用されます。
-
DeviceName
-
型: char
-
GDI のデバイス名。
-
DriverVersion
-
種類: LARGE_INTEGER
-
Direct3D ドライバーのバージョンを特定します。 64 ビット符号付き整数値に対する比較より小さく、より大きい方が適しています。 ただし、この要素を使用して問題のあるドライバーを特定する場合は注意が必要です。 代わりに、DeviceIdentifier を使用する必要があります。 「解説」を参照してください。
-
DriverVersionLowPart
-
種類: DWORD
-
Direct3D ドライバーのバージョンを特定します。 64 ビット符号付き整数値に対して と > を比較することは有効<です。 ただし、この要素を使用して問題のあるドライバーを特定する場合は注意が必要です。 代わりに、DeviceIdentifier を使用する必要があります。 「解説」を参照してください。
-
DriverVersionHighPart
-
種類: DWORD
-
Direct3D ドライバーのバージョンを特定します。 64 ビット符号付き整数値に対して と > を比較することは有効<です。 ただし、この要素を使用して問題のあるドライバーを特定する場合は注意が必要です。 代わりに、DeviceIdentifier を使用する必要があります。 「解説」を参照してください。
-
VendorId
-
種類: DWORD
-
特定のチップ セットを識別するために使用できます。 このメンバーに対してクエリを実行して、製造元を特定します。 不明な場合、値は 0 にすることができます。
-
DeviceId
-
種類: DWORD
-
特定のチップ セットを識別するために使用できます。 このメンバーにクエリを実行して、チップ セットの種類を特定します。 不明な場合、値は 0 にすることができます。
-
SubSysId
-
種類: DWORD
-
特定のチップ セットを識別するために使用できます。 このメンバーにクエリを実行して、サブシステム (通常は特定のボード) を識別します。 不明な場合、値は 0 にすることができます。
-
Revision
-
種類: DWORD
-
特定のチップ セットを識別するために使用できます。 このメンバーにクエリを実行して、チップ セットのリビジョン レベルを特定します。 不明な場合、値は 0 にすることができます。
-
DeviceIdentifier
-
種類: GUID
-
ドライバーとチップ セットの変更をチェックするためにクエリを実行できます。 この GUID は、ドライバーとチップ セットのペアの一意の識別子です。 グラフィックス サブシステムの新しいプロファイルを生成するために、このメンバーに対してクエリを実行して、ドライバーとチップ セットの変更を追跡します。 DeviceIdentifier を使用して、特定の問題のあるドライバーを特定することもできます。
-
WHQLLevel
-
種類: DWORD
-
このドライバーとデバイスのペアの Windows Hardware Quality Labs (WHQL) 検証レベルを決定するために使用されます。 DWORD は、ドライバーによって渡された最新の WHQL テストのリリース日を定義するパックされた日付構造です。 この値に対して と > 操作を実行<することは有効です。 日付形式を次に示します。
Bits 説明 31-16 年。1999 年以降の 10 進数。 15-8 月。1 から 12 までの 10 進数。 7-0 日。1 から 31 までの 10 進数。 次の値も使用されます。
値 説明 0 認定されていません。 1 WHQL は検証されましたが、日付情報は使用できません。 Direct3D 9 と Direct3D 9Ex の違い:
Windows Vista、Windows Server 2008、Windows 7、および Windows Server 2008 R2 (またはそれ以上の現在のオペレーティング システム) で実行されている Direct3D9Ex の場合、ドライバーの状態を確認せずに WHQL レベルの IDirect3D9::GetAdapterIdentifier は 1 を返します。
解説
次の擬似コードの例は、DriverVersion、DriverVersionLowPart、および DriverVersionHighPart メンバーでエンコードされたバージョン形式を示しています。
Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)
HIWORD マクロ、LOWORD マクロ、およびLARGE_INTEGER構造の詳細については、プラットフォーム SDK を参照してください。
MAX_DEVICE_IDENTIFIER_STRINGは、次の定義を持つ定数です。
#define MAX_DEVICE_IDENTIFIER_STRING 512
VendorId、DeviceId、SubSysId、Revision の各メンバーを組み合わせて使用して、特定のチップ セットを識別できます。 ただし、これらのメンバーは注意して使用してください。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
関連項目