D3DADAPTER_IDENTIFIER9

[アーティクル]
04/08/2010

アダプターについての情報を保持します。

typedef struct D3DADAPTER_IDENTIFIER9 {
    char Driver[MAX_DEVICE_IDENTIFIER_STRING];
    char Description[MAX_DEVICE_IDENTIFIER_STRING];
    char DeviceName[32];
    LARGE_INTEGER DriverVersion;
    DWORD DriverVersionLowPart;
    DWORD DriverVersionHighPart;
    DWORD VendorId;
    DWORD DeviceId;
    DWORD SubSysId;
    DWORD Revision;
    GUID DeviceIdentifier;
    DWORD WHQLLevel;
} D3DADAPTER_IDENTIFIER9, *LPD3DADAPTER_IDENTIFIER9;

メンバ

Driver
ユーザーに提示するために使用します。ベンダーの異なる同一のデバイスおよびドライバーに対して、複数の異なる文字列が関連付けられる可能性があるため、特定のドライバーの識別にこの値を使用しないでください。
Description
ユーザーに提示するために使用します。
DeviceName
GDI のデバイス名です。
DriverVersion
Microsoft Direct3D ドライバーのバージョン番号を識別します。64 ビット符号付き整数値で大小比較を実行しても問題はありません。ただし、この要素を使用して疑わしいドライバーを特定する場合には注意が必要です。その場合は、この値ではなく、DeviceIdentifier を使うようにしてください。「解説」を参照してください。
DriverVersionLowPart
Microsoft Direct3D ドライバーのバージョン番号を識別します。64 ビット符号付き整数値で大小比較を実行しても問題はありません。ただし、この要素を使用して疑わしいドライバーを特定する場合には注意が必要です。その場合は、この値ではなく、DeviceIdentifier を使うようにしてください。「解説」を参照してください。
DriverVersionHighPart
Microsoft Direct3D ドライバーのバージョン番号を識別します。64 ビット符号付き整数値で大小比較を実行しても問題はありません。ただし、この要素を使用して疑わしいドライバーを特定する場合には注意が必要です。その場合は、この値ではなく、DeviceIdentifier を使うようにしてください。「解説」を参照してください。
VendorId
特定のチップセットを識別するのに使用できます。製造元を識別するには、このメンバーをクエリします。不明な場合、この値が 0 になることがあります。
DeviceId
特定のチップセットを識別するのに使用できます。チップセットの種類を識別するには、このメンバーをクエリします。不明な場合、この値が 0 になることがあります。
SubSysId
特定のチップセットを識別するのに使用できます。サブシステムを識別するには、このメンバーをクエリします。一般に、サブシステムとは特定のボードを指します。不明な場合、この値が 0 になることがあります。
Revision
特定のチップセットを識別するのに使用できます。チップセットの種類を識別するには、このメンバーをクエリします。不明な場合、この値が 0 になることがあります。
DeviceIdentifier
このメンバーを調べると、ドライバーおよびチップセットの変更を確認できます。この GUID は、ドライバーとチップセットのペアとして一意な識別子です。グラフィックスサブシステムの新しいプロファイルを作成するためにドライバーおよびチップセットへの変更を追跡する場合は、このメンバーをクエリします。DeviceIdentifier を使用して、問題のあるドライバーを特定することもできます。
WHQLLevel
このドライバーおよびデバイスのペアに対する WHQL (Windows Hardware Quality Lab) 検証レベルを特定するときに使用します。DWORD は、パックされた日付構造体で、ドライバーが合格した最も新しい WHQL テストのリリース日が入っています。この値で大小比較演算を実行しても問題はありません。以下は、日付のフォーマットです。

ビット
31-16	年。1999 年以降を 10 進数で表したもの。
15-8	月。1 月～ 12 月を 10 進数で表したもの。
7-0	日。1 日～ 31 日を 10 進数で表したもの。

次の値も使用できます。

0	認証されていません。
1	WHQL の検証は受けていますが、利用できる日付情報はありません。

解説　

次の疑似コードの例は、DriverVersion、DriverVersionLowPart、および DriverVersionHighPart メンバーで符号化されるバージョンのフォーマットを示しています。

 Product = HIWORD(DriverVersion.HighPart) Version = LOWORD(DriverVersion.HighPart) SubVersion = HIWORD(DriverVersion.LowPart) Build = LOWORD(DriverVersion.LowPart)

HIWORD マクロ、LOWORD マクロ、および LARGE_INTEGER 構造の詳細については、Platfrom SDK を参照してください。

定数 MAX_DEVICE_IDENTIFIER_STRING は、次のように定義されています。

#define MAX_DEVICE_IDENTIFIER_STRING        512

VendorId、DeviceId、SubSysId、および Revision メンバーは、特定のチップセットを識別するのに使用できます。ただし、これらのメンバーを使うときは注意が必要です。

要件

ヘッダー: D3D9Types.h 宣言

次の方法で共有

D3DADAPTER_IDENTIFIER9

メンバ

解説

要件

その他のリソース