D3DDDIARG_OPENADAPTER 結構 (d3dumddi.h)

D3DDDIARG_OPENADAPTER 結構包含描述圖形配接器物件的資訊。

語法

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

成員

[in/out] hAdapter

圖形配接器物件的句柄。 在 OpenAdapter 函式的輸入上， hAdapter 會指定驅動程式在驅動程式呼叫 Microsoft Direct3D 運行時間提供的 pfnQueryAdapterInfoCb 回 呼函式時，驅動程式應該用來查詢圖形配接器的句柄。

驅動程式會產生唯一的句柄，並將它傳回 Direct3D 運行時間。 在 OpenAdapter 函式的輸出上， hAdapter 會指定 Direct3D 執行時間在後續驅動程式呼叫中使用的句柄，以識別圖形配接器物件。

[in] Interface

Direct3D/DirectDraw 介面版本 (例如開啟圖形適配卡的 7、8 或 9) 。

[in] Version

驅動程式可用來識別何時建置 Direct3D/DirectDraw 運行時間的數位。 例如，驅動程式可以使用版本號碼來區分使用 Windows Vista 發行的運行時間，以及後續 Service Pack 發行的運行時間，其中可能包含驅動程式所需的修正程式。

[in] pAdapterCallbacks

D3DDDI_ADAPTERCALLBACKS 結構的指標，其中包含驅動程式可以使用的 Direct3D 運行 時間 提供的 pfnQueryAdapterInfoCb 回呼函式。

[out] pAdapterFuncs

D3DDDI_ADAPTERFUNCS 結構的指標，其中包含使用者模式顯示驅動程式配接器特定函式的數據表。 Direct3D 執行時間會使用這些函式來與使用者模式顯示驅動程式通訊，以了解圖形適配卡特有的作業。

[out] DriverVersion

從驅動程式編譯的 D3dumddi.h 頭檔取得的 Direct3D 使用者模式顯示驅動程式介面版本。 使用者模式顯示驅動程式應該會傳回D3D_UMD_INTERFACE_VERSION。

注意 如果使用者模式驅動程式不支援 Windows 7 功能 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) ，而且您想要使用 Windows 7 WDK (版本 7600) 編譯驅動程式，請確定驅動程式會傳回D3D_UMD_INTERFACE_VERSION_VISTA。

 

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭	d3dumddi.h (包含 D3dumddi.h)

另請參閱

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb