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) |