PFND3DDDI_GETCAPS回呼函式 (d3dumddi.h)

D3D 運行時間會呼叫驅動程式 的PFND3DDDI_GETCAPS 回呼函式,以查詢圖形適配卡的功能。

語法

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

參數

hAdapter

識別圖形配接器的句柄。

unnamedParam2

pData [in, out]

描述要擷取之功能 之D3DDDIARG_GETCAPS 結構的指標。

傳回值

PFND3DDDI_GETCAPS 會傳回下列其中一個值:

傳回碼 描述
S_OK 已成功擷取功能。
E_OUTOFMEMORY PFND3DDDI_GETCAPS無法配置所需的記憶體,使其完成。

備註

D3DDDIARG_GETCAPS 結構之 pData 成員中傳回的數據取決於 (要求的數據類型,也就是數據相依於D3DDDIARG_GETCAPS。在pInfo 成員) 輸入 與 。

下表有兩個範例,說明如何根據D3DDDIARG_GETCAPS的值來設定 PFND3DDDI_GETCAPS 呼叫 。類型

D3DDDIARG_GETCAPS成員 範例 1 範例 2
類型 D3DDDICAPS_DDRAW D3DDDICAPS_GETFORMATCOUNT
pInfo [in]NULL (未設定任何條件) [in]NULL (未設定任何條件)
pData [out] DDRAW_CAPS (唯一指標) [out]UINT* (唯一指標)
DataSize sizeof (DDRAW_CAPS) sizeof (UINT)
備註 驅動程式必須填入其支援的 DirectDraw 功能 DDRAW_CAPS 結構。 驅動程式必須使用 UINT 值填滿 pData 所指向的緩衝區,這個值代表裝置支援的 D3DDDIFORMAT 介面格式數目。

如需D3DDDIARG_GETCAPS的其他值說明 請參閱 D3DDDIARG_GETCAPS。 用於多平面重疊的類型。

Simple_instancing

如果支援 Windows 顯示驅動程式模型的 Direct3D 層級 9 驅動程式 (WDDM) 1.3 和更新版本完成PFND3DDDI_GETCAPS呼叫並傳回 S_OK ,但不會變更 D3DDDIARG_GETCAPS 結構中的數據,則會向 Direct3D 運行時間指出硬體和驅動程式不支援簡單的實例。 如需詳細資訊,請參閱 D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

規格需求

需求
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 d3dumddi.h (包含 D3dumddi.h)

另請參閱

D3DDDIARG_GETCAPS

D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

D3DDDIFORMAT

D3DDDI_ADAPTERFUNCS

DDRAW_CAPS