IDXGIOutput::FindClosestMatchingMode メソッド (dxgi.h)

  • [アーティクル]

[Direct3D 11.1 以降では、 FindClosestMatchingMode を使用して、要求された表示モードに最も近い表示モードを検索しないことをお勧めします。 代わりに、ステレオ表示モードをサポートする IDXGIOutput1::FindClosestMatchingMode1 を使用します。

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

構文

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

パラメーター

[in] pModeToMatch

型: const DXGI_MODE_DESC*

目的の表示モード ( 「DXGI_MODE_DESC」を参照)。 DXGI_MODE_DESCのメンバーは、そのメンバーの優先順位を示さないことを示して指定できます。 Width または Height の値が 0 の場合は、値が指定されていないことを示します。 Width または Height が 0 の場合、両方とも 0 である必要があります。 RefreshRate の分子と分母 0 は、指定されていないことを示します。 DXGI_MODE_DESCの他のメンバーには、メンバーが指定されていないことを示す列挙値があります。 pConcernedDevice が NULL の場合、Format をDXGI_FORMAT_UNKNOWNすることはできません。

[out] pClosestMatch

種類: DXGI_MODE_DESC*

pModeToMatch に最も近いモード。

[in, optional] pConcernedDevice

種類: IUnknown*

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

戻り値

種類: HRESULT

次のいずれかの DXGI_ERRORを返します。

解説

FindClosestMatchingMode は IDXGIOutput1::FindClosestMatchingMode1 と同様に動作しますが、 FindClosestMatchingMode では mono 表示モードのみが考慮されます。 IDXGIOutput1::FindClosestMatchingMode1 は、pModeToMatch が指すDXGI_MODE_DESC1構造で Stereo メンバーを設定した場合にのみステレオ モードを考慮し、Stereo が設定されていない場合はモノラル モードのみを考慮します。

IDXGIOutput1::FindClosestMatchingMode1 は、ステレオ モードのみ、またはモノラル モードのみを使用して一致する表示モード セットを返します。 FindClosestMatchingMode は、入力モードを mono として指定したかのように動作します。

要件

   
対象プラットフォーム Windows
ヘッダー dxgi.h
Library DXGI.lib

関連項目

IDXGIOutput