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 オペレーティング システムで使用できます。
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3d10umddi.h (D3d10umddi.h を含む)

関連項目

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb の