PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS コールバック関数 (d3d10umddi.h)

  • [アーティクル]

CheckMultisampleQualityLevels 関数は、指定されたサンプル数に対してデバイスがサポートする品質レベルの数を取得します。

構文

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

パラメーター

unnamedParam1

hDevice [in]

ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。

unnamedParam2

書式 [入力]

チェックが実行されるレンダー ターゲット形式を示すDXGI_FORMAT型指定された値。

unnamedParam3

SampleCount [in]

品質レベルを取得するサンプルの数。

unnamedParam4

pNumQualityLevels [out]

指定したサンプル数に対してデバイスがサポートする品質レベルの数を受け取る変数へのポインター。

戻り値

なし

解説

ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。 Format パラメーターの 形式が存在しない場合、または pNumQualityLevels パラメーターが NULL の場合、ドライバーはE_INVALIDARGを設定できます。

デバイスが SampleCount パラメーターで指定されたサンプルの数で複数のサンプリングをサポートしていない場合、ユーザー モードディスプレイ ドライバーは 、pNumQualityLevels パラメーターが指す変数に 0 を返す必要があります。

ドライバーが pNumQualityLevels が指す変数で 1 つ以上を返すと、ドライバーは、指定されたサンプル数で使用できるデバイス固有のサンプリング バリエーションの数を示します。 たとえば、ドライバーから 3 が返された場合、品質レベル 0、1、2 を使用して、指定されたサンプル数のリソースを作成できます。 デバイスの製造元は、Microsoft Direct3D ランタイムがクエリを実行できないこれらの品質レベルを定義します。 ただし、固定サンプル数の品質レベルが異なると、サンプルの場所の空間レイアウトや解決方法が異なる場合があります。

ドライバーが SampleCount で 1 を受け取った場合、ドライバーは常に pNumQualityLevels が指す変数で 1 を返します。

ドライバーが SampleCount で 0 または 32 より大きい値を受け取った場合、ドライバーは常に pNumQualityLevels が指す変数で 0 を返します。

要件

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

こちらもご覧ください

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb