PFND3DDDI_GETMULTISAMPLEMETHODLISTCB コールバック関数 (d3dumddi.h)

[アーティクル]
02/26/2024

pfnGetMultisampleMethodListCb 関数は、割り当ての指定された幅、高さ、および形式に使用される複数サンプルメソッドの一覧を取得します。

構文

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
  HANDLE hAdapter,
  D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}

パラメーター

hAdapter

グラフィックスアダプターオブジェクトへのハンドル。

unnamedParam2

pData [in, out]

割り当ての複数サンプルメソッドの一覧を記述する D3DDDICB_GETMULTISAMPLEMETHODLIST構造体へのポインター。

戻り値

pfnGetMultisampleMethodListCb は、次のいずれかの値を返します。

リターンコード	説明
S_OK	複数のサンプルメソッドの一覧が正常に取得されました。
E_INVALIDARG	パラメーターが検証され、正しくないと判断されました。

この関数は、他の HRESULT 値も返す場合があります。

注釈

通常、ユーザーモードディスプレイドライバーは、createResource、CreateResource(D3D10)、または CreateResource(D3D11 ) 関数と pfnAllocateCb 関数を使用して pfnGetMultisampleMethodListCb 関数を使用します。ドライバーは、Direct3D ランタイムがドライバーの CreateResource、CreateResource(D3D10)、または CreateResource(D3D11) を呼び出して、ドライバーが複数サンプリングされたプライマリを作成するように要求するときに、pfnGetMultisampleMethodListCb を使用します。ドライバーは、プライマリからのスキャン中に複数サンプリングを実行する必要がある場合にも pfnGetMultisampleMethodListCb を使用します。この種類のマルチサンプリングでは、表示モードのスキャンに必要な帯域幅を超えて、追加のメモリ帯域幅が消費される可能性があります。したがって、 pfnGetMultisampleMethodListCb は、表示モードマネージャー (DMM) (および間接的にディスプレイミニポートドライバー) に対してクエリを実行して、指定された幅、高さ、および形式に対してサポートされている複数サンプリングメソッドの一覧を取得します。 pfnGetMultisampleMethodListCb がメソッドがサポートされていないことを報告する場合、ユーザーモードのディスプレイドライバーでは、通常、標準の非マルチプルサンプリングプライマリを作成することによって、非スキャンバージョンのマルチサンプリングを使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	d3dumddi.h (D3dumddi.h を含む)