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 呼び出しを設定する方法の 2 つの例を示します。「」と入力します。
| 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 構造体に入力する必要があります。 | ドライバーは、pData が指すバッファーに、デバイスがサポートする D3DDDIFORMAT サーフェス形式の数を表す UINT 値を入力する必要があります。 |
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 を含む) |