ID3D11Device::CheckMultisampleQualityLevels

  • [アーティクル]

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

HRESULT 
CheckMultisampleQualityLevels(
  DXGI_FORMAT Format,
  UINT SampleCount,
  UINT *pNumQualityLevels
);

パラメータ

  • Format
    テクスチャー フォーマット。「DXGI_FORMAT」を参照してください。
  • SampleCount
    マルチサンプリング時のサンプル数です。
  • pNumQualityLevels
    アダプターでサポートされる品質レベルの数です。「解説」を参照してください。

戻り値

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

解説　

テクスチャーのマルチサンプリングの際にアダプターで利用可能な品質レベルの数は、使用されるテクスチャー フォーマットと要求されるサンプル数によって異なります。品質レベルの最大数は、D3D11.h の D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT で定義します。このメソッドが 0 を返す場合、そのフォーマットとサンプル カウントの組み合わせは、インストールされたアダプターではサポートされていません。

さらに、品質レベルの定義は、それを定義する各ハードウェア ベンダーごとに異なりますが、この情報の検出に役立つ機能は Direct3D では提供されません。

R32G32B32A32 および R32G32B32 を除くすべてのレンダー ターゲットで 4x MSAA をサポートするには、FEATURE_LEVEL_10_1 デバイスが必要です。すべてのレンダー ターゲット フォーマットで 4x MSAA をサポートする場合、また R32G32B32A32 フォーマットを除くすべてのレンダー ターゲット フォーマットで 8x MSAA をサポートする場合は、FEATURE_LEVEL_11_0 デバイスが必要です。

要件

ヘッダー: D3D11.h 宣言

ライブラリ: D3D11.lib 内容

関連項目

ID3D11Device