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 の形式と一致するモードのみが返されます。それ以外の場合は、デバイスによるスキャンアウトでサポートされている形式のみが返されます。 各機能レベルでのデバイスによるスキャンアウトでサポートされる形式の詳細については、以下を参照してください。
- Direct3D 機能レベル 12.1 ハードウェアの DXGI 形式サポート
- Direct3D 機能レベル 12.0 ハードウェアの DXGI 形式サポート
- Direct3D 機能レベル 11.1 ハードウェアの DXGI 形式サポート
- Direct3D 機能レベル 11.0 ハードウェアの DXGI 形式サポート
- Direct3D 10Level9 形式のハードウェア サポート
- Direct3D 10.1 形式のハードウェア サポート
- Direct3D 10 形式のハードウェア サポート
戻り値
種類: 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 |