IDirect3D9::GetAdapterIdentifier 方法 (d3d9.h)
描述具現化 IDirect3D9 介面時,系統中存在的實體顯示配接器。
語法
HRESULT GetAdapterIdentifier(
[in] UINT Adapter,
[in] DWORD Flags,
[out] D3DADAPTER_IDENTIFIER9 *pIdentifier
);
參數
[in] Adapter
類型: UINT
代表顯示配接器的序號。 D3DADAPTER_DEFAULT一律是主要顯示配接器。 此參數的最小值為 0,而此參數的最大值則小於 GetAdapterCount 所傳回的值。
[in] Flags
類型: DWORD
旗標會設定D3DADAPTER_IDENTIFIER9的 WHQLLevel 成員。 旗標可以設定為 0 或 D3DENUM_WHQL_LEVEL。 如果指定D3DENUM_WHQL_LEVEL,此呼叫可以連線到因特網,以下載新的 Microsoft Windows Hardware Quality Labs (WHQL) 憑證。
Direct3D 9 與 Direct3D 9Ex 之間的差異:
D3DENUM_WHQL_LEVEL已淘汰在 Windows Vista、Windows Server 2008、Windows 7 和 Windows Server 2008 R2 上執行的 Direct3D9Ex (或更多目前的操作系統) 。 任何這些操作系統在 D3DADAPTER_IDENTIFIER9 的 WHQLLevel 成員中傳回 1,而不檢查驅動程式的狀態。
[out] pIdentifier
要填入描述此配接器之資訊的 D3DADAPTER_IDENTIFIER9 結構的指標。 如果 Adapter 大於或等於系統中的配接器數目,此結構將會為零。
傳回值
類型: HRESULT
如果方法成功,傳回值會D3D_OK。 如果 Adapter 超出範圍、如果 Flags 包含無法辨識的參數,或 pIdentifier 為 NULL 或指向無法寫入的記憶體,則會傳回D3DERR_INVALIDCALL。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | d3d9.h (包含 D3D9.h) |
程式庫 | D3D9.lib |