共用方式為


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

可用來協助識別特定的晶片集。 查詢此成員以識別製造商。 如果未知,此值可以是零。

DeviceId

類型: DWORD

可用來協助識別特定的晶片集。 查詢此成員以識別晶片集的類型。 如果未知,此值可以是零。

SubSysId

類型: DWORD

可用來協助識別特定的晶片集。 查詢此成員以識別子系統,通常是特定面板。 如果未知,此值可以是零。

修訂版

類型: DWORD

可用來協助識別特定的晶片集。 查詢此成員以識別晶片集的修訂層級。 如果未知,此值可以是零。

DeviceIdentifier

類型: GUID

您可以查詢以檢查驅動程式和晶片集中的變更。 此 GUID 是驅動程式和晶片集組的唯一識別碼。 查詢此成員以追蹤驅動程式和晶片集的變更,以產生圖形子系統的新設定檔。 DeviceIdentifier 也可以用來識別特定有問題的驅動程式。

WHQLLevel

類型: DWORD

用來判斷此驅動程式和裝置組的 Windows 硬體品質實驗室 (WHQL) 驗證等級。 DWORD 是一種已封裝的日期結構,定義驅動程式所通過的最新 WHQL 測試發行日期。 對此值執行 < 和 > 作業是合法的。 下列說明日期格式。

Bits 描述
31-16 年份,從 1999 向上十進位數。
15-8 月份,從 1 到 12 的十進位數。
7-0 日,從 1 到 31 的十進位數。

 

也會使用下列值。

描述
0 未通過認證。
1 WHQL 已驗證,但沒有可用的日期資訊。

 

Direct3D 9 與 Direct3D 9Ex 之間的差異:

對於在 Windows Vista 上執行的 Direct3D9Ex,Windows Server 2008、Windows 7 和 Windows Server 2008 R2 (或更多目前的作業系統) , IDirect3D9::GetAdapterIdentifier 會針對 WHQL 層級傳回 1,而不會檢查驅動程式的狀態。

備註

下列虛擬程式碼範例說明以 DriverVersion、DriverVersionLowPart 和 DriverVersionHighPart 成員編碼的版本格式。

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

如需 HIWORD 宏、LOWORD 宏和LARGE_INTEGER結構的詳細資訊,請參閱 Platform SDK。

MAX_DEVICE_IDENTIFIER_STRING是具有下列定義的常數。

#define MAX_DEVICE_IDENTIFIER_STRING        512

VendorId、DeviceId、SubSysId 和 Revision 成員可以同時用來識別特定的晶片集。 不過,請小心使用這些成員。

規格需求

需求
標頭
D3D9Types.h

另請參閱

Direct3D 結構