IDXGIOutput_FindClosestMatchingMode

要求されたディスプレイモードに最も近いディスプレイモードを検索する。(IDXGIOutput.FindClosestMatchingMode)

IDXGIOutput_FindClosestMatchingMode this, pModeToMatch, pClosestMatch, pConcernedDevice

this : [comobj] IDXGIOutput インターフェースの COM オブジェクト変数
pModeToMatch : [var] 型: 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 にすることはできない。
pClosestMatch : [var] 型: DXGI_MODE_DESC* pModeToMatch に最も近いモード。
pConcernedDevice : [int] 型: IUnknown* Direct3D デバイスインターフェースへのポインタ。このパラメータが NULL の場合、フォーマットが pModeToMatch と一致するモードのみが返される。それ以外の場合は、デバイスがスキャンアウト用にサポートしているフォーマットのみが返される。各機能レベルでデバイスがスキャンアウト用にサポートしているフォーマットの詳細:

(プラグイン / モジュール : com_misc.dll)

解説

要求されたディスプレイモードに最も近いディスプレイモードを検索する。(IDXGIOutput.FindClosestMatchingMode)

[戻り値]
型: HRESULT 次の DXGI_ERROR のいずれかを返す。

[備考]
FindClosestMatchingMode は IDXGIOutput1::FindClosestMatchingMode1
と同様に動作するが、FindClosestMatchingMode
はモノラルディスプレイモードのみを考慮する点が異なる。IDXGIOutput1::FindClosestMatchingMode1
は、pModeToMatch が指す DXGI_MODE_DESC1 構造体の Stereo
メンバを設定した場合のみステレオモードを考慮し、Stereo が設定されていない場合はモノラルモードのみを考慮する。
IDXGIOutput1::FindClosestMatchingMode1
はステレオモードのみまたはモノラルモードのみを含む一致したディスプレイモードセットを返す。FindClosestMatchingMode
は入力モードをモノラルとして指定したかのように動作する。

情報