次の方法で共有

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 の各メンバーを組み合わせて使用して、特定のチップ セットを識別できます。 ただし、これらのメンバーは注意して使用してください。

要件

要件 値
ヘッダー
D3D9Types.h

関連項目

Direct3D 構造体