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無法配置所需的記憶體，使其完成。 |
言論
pData 中傳回的數據D3DDDIARG_GETCAPS 結構成員取決於所要求的數據類型（也就是數據相依於 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） |
| 筆記 | 驅動程式必須填入 DDRAW_CAPS 結構，其中包含其支援的 DirectDraw 功能。 | 驅動程式必須以 UINT 值填滿 pData 所指向的緩衝區，這個值代表裝置支援的 D3DDDIFORMAT 介面格式數目。 |
如需 D3DDDIARG_GETCAPS 的其他值說明，請參閱 D3DDDIARG_GETCAPS。用於多平面重疊的類型。
Simple_instancing
如果支援 Windows 顯示驅動程式模型 （WDDM） 1.3 和更新版本的 Direct3D 層級 9 驅動程式完成 PFND3DDDI_GETCAPS 呼叫，並傳回S_OK，但不會變更 D3DDDIARG_GETCAPS 結構中的數據，則會向 Direct3D 運行時間指出硬體和驅動程式不支援簡單的實例。 如需詳細資訊，請參閱 D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | d3dumddi.h （包括 D3dumddi.h） |