IDXGIOutput1::FindClosestMatchingMode1 メソッド (dxgi1_2.h)

  • [アーティクル]

要求された表示モードに最も近い表示モードを検索します。

構文

HRESULT FindClosestMatchingMode1(
  [in]           const DXGI_MODE_DESC1 *pModeToMatch,
  [out]          DXGI_MODE_DESC1       *pClosestMatch,
  [in, optional] IUnknown              *pConcernedDevice
);

パラメーター

[in] pModeToMatch

一致する表示モードを記述する DXGI_MODE_DESC1 構造体へのポインター。 DXGI_MODE_DESC1のメンバーは指定できません。これは、そのメンバーの優先順位を示しません。 Width または Height の値が 0 の場合は、値が指定されていないことを示します。 Width または Height が 0 の場合、両方とも 0 である必要があります。 RefreshRate の分子と分母 0 は、指定されていないことを示します。 DXGI_MODE_DESC1の他のメンバーには、メンバーが指定されていないことを示す列挙値があります。 pConcernedDevice が NULL の場合、DXGI_MODE_DESC1の Format メンバーをDXGI_FORMAT_UNKNOWNすることはできません。

[out] pClosestMatch

pModeToMatch で説明されている表示モードに最も近い表示モードの説明を受け取る、DXGI_MODE_DESC1構造体へのポインター。

[in, optional] pConcernedDevice

Direct3D デバイス インターフェイスへのポインター。 このパラメーターが NULL の場合、 FindClosestMatchingMode1 は pModeToMatch の形式と一致するモードのみを返します。それ以外の場合、 FindClosestMatchingMode1 は、デバイスによるスキャンアウトでサポートされている形式のみを返します。 各機能レベルでのデバイスによるスキャンアウトでサポートされる形式の詳細については、以下を参照してください。

戻り値

DXGI_ERRORトピックで説明されているエラー コードの 1 つを返します。

注釈

Direct3D デバイスには UNORM 形式が必要です。

FindClosestMatchingMode1 は、 pModeToMatch で指定したモードに最も近い一致する使用可能な表示モードを検索します。

pModeToMatch が指すDXGI_MODE_DESC1構造で Stereo メンバーを設定してステレオ モードを入力として指定した場合、FindClosestMatchingMode1 はステレオ モードのみを考慮します。 FindClosestMatchingMode1 では、 Stereo が設定されていない場合、モノラル モードのみが考慮されます。

FindClosestMatchingMode1 は、表示モードの同様にランク付けされたメンバー (つまり、指定されたすべてのメンバー、または指定されていないすべてのメンバーなど) を次の順序で解決します。

  1. ScanlineOrdering
  2. スケーリング
  3. Format
  4. 解像度
  5. RefreshRate
FindClosestMatchingMode1 は、特定のメンバーの最も近い値を決定すると、以前に一致したメンバーを使用して表示モード リストの選択肢をフィルター処理し、他のメンバーを無視します。 たとえば、 FindClosestMatchingMode1 が Resolution と一致する場合、表示モード リストは既に特定の ScanlineOrdering、 Scaling、 Format でフィルター処理されていますが、 RefreshRate は無視されます。 この順序付けでは 、FindClosestMatchingMode1 のすべての使用シナリオで絶対順序が定義されるわけではありません。これは、アプリケーションが最初にいくつかの値を選択できるため、メンバーの解決順序を効果的に変更するためです。

FindClosestMatchingMode1 は、表示モードのメンバーを一度に 1 つずつ、通常は指定した順序で照合します。

メンバーが指定されていない場合、 FindClosestMatchingMode1 は、この出力に関連するデスクトップの値に向かって引き寄せられます。 この出力がデスクトップに含まれていない場合、 FindClosestMatchingMode1 は既定のデスクトップ出力を使用して値を検索します。 アプリケーションが完全に指定されていない表示モードを使用している場合、 FindClosestMatchingMode1 は通常、この出力のデスクトップ設定と一致する表示モードを返します。
指定されていないメンバーは指定されたメンバーよりも優先度が低いため、 FindClosestMatchingMode1 は指定されたメンバーより後で指定されていないメンバーを解決します。

要件

要件 値
サポートされている最小のクライアント Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー dxgi1_2.h
Library DXGI.lib

こちらもご覧ください

IDXGIOutput1