PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS コールバック関数 (d3d10umddi.h)
PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS は、指定したサンプル数に対してデバイスがサポートする品質レベルの数を取得します。
構文
PFND3DWDDM1_3DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3dwddm13DdiCheckmultisamplequalitylevels;
void Pfnd3dwddm13DdiCheckmultisamplequalitylevels(
D3D10DDI_HDEVICE hDevice,
DXGI_FORMAT Format,
UINT SampleCount,
UINT Flags,
UINT *pNumQualityLevels
)
{...}
パラメーター
hDevice
ディスプレイ デバイス (グラフィックス コンテキスト) へのハンドル。
Format
チェックが実行されるレンダー ターゲット形式を示す DXGI_FORMAT 型の値。
SampleCount
品質レベルを取得するサンプルの数。
Flags
ビットごとの OR 演算を使用して結合される D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG 値の組み合わせ。
pNumQualityLevels
指定したサンプル数に対してデバイスがサポートする品質レベルの数を受け取る変数へのポインター。
戻り値
なし
解説
ドライバーは 、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 8.1 (WDDM 1.3) |
| サポートされている最小のサーバー | Windows Server 2012 R2 |
| 対象プラットフォーム | デスクトップ |
| Header | d3d10umddi.h (D3d10umddi.h を含む) |