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 |
|---|---|---|
| Type | D3DDDICAPS_DDRAW | D3DDDICAPS_GETFORMATCOUNT |
| Pinfo | [入力]NULL (条件が設定されていません) | [入力]NULL (条件が設定されていません) |
| pData | [out] DDRAW_CAPS (一意のポインター) | [out]UINT* (一意のポインター) |
| DataSize | sizeof(DDRAW_CAPS) | sizeof(UINT) |
| メモ | ドライバーは、 DDRAW_CAPS 構造体に、それがサポートする DirectDraw 機能を入力する必要があります。 | ドライバーは、 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 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |