ID3D11Device::CheckMultisampleQualityLevels メソッド (d3d11.h)

マルチサンプリング中に使用可能な品質レベルの数を取得します。

構文

HRESULT CheckMultisampleQualityLevels(
  [in]  DXGI_FORMAT Format,
  [in]  UINT        SampleCount,
  [out] UINT        *pNumQualityLevels
);

パラメーター

[in] Format

種類: DXGI_FORMAT

テクスチャ形式。 「DXGI_FORMAT」を参照してください。

[in] SampleCount

型: UINT

マルチサンプリング中のサンプルの数。

[out] pNumQualityLevels

型: UINT*

アダプターでサポートされている品質レベルの数。 「解説」を参照してください。

戻り値

種類: HRESULT

このメソッドは、次のいずれかの Direct3D 11 リターン コードを返します。

注釈

テクスチャをマルチサンプリングする場合、アダプターで使用できる品質レベルの数は、使用されるテクスチャ形式と要求されたサンプルの数によって異なります。 品質レベルの最大数は、 のD3D11_MAX_MULTISAMPLE_SAMPLE_COUNTD3D11.hによって定義されます。 このメソッドが 0 (S_OK) を返し、出力パラメーター pNumQualityLevels が正の値を受け取る場合、デバイスでは形式とサンプル数の組み合わせがサポートされます。 この組み合わせがサポートされていない場合、このメソッドはエラー HRESULT コード (つまり負の整数) を返すか、出力パラメーターを 0 または両方に設定 pNumQualityLevels します。

さらに、品質レベルの定義は、定義する各ハードウェア ベンダーに任されます。ただし、この情報を検出するのに役立つ機能は Direct3D によって提供されていません。

R32G32B32A32とR32G32B32を除くすべてのレンダー ターゲットで 4 倍の MSAA をサポートするには、FEATURE_LEVEL_10_1 デバイスが必要であることに注意してください。 FEATURE_LEVEL_11_0 デバイスでは、すべてのレンダー ターゲット形式に対して 4 倍の MSAA をサポートし、R32G32B32A32形式を除くすべてのレンダー ターゲット形式に対して 8x MSAA をサポートする必要があります。

要件

こちらもご覧ください

ID3D11Device