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 成員可以同時用來識別特定的晶片集。 不過,請小心使用這些成員。
規格需求
需求 | 值 |
---|---|
標頭 |
|
另請參閱