IDXGIOutput_GetDisplayModeList

要求されたフォーマットとその他の入力オプションに一致するディスプレイモードを取得する。(IDXGIOutput.GetDisplayModeList)

IDXGIOutput_GetDisplayModeList this, EnumFormat, Flags, pNumModes, pDesc

this : [comobj] IDXGIOutput インターフェースの COM オブジェクト変数
EnumFormat : [int] 型: DXGI_FORMAT カラーフォーマット (DXGI_FORMAT を参照)。
Flags : [int] 型: UINT 含めるモードのオプション (DXGI_ENUM_MODES を参照)。スケーリングが必要なディスプレイモードを公開するには DXGI_ENUM_MODES_SCALING を指定する必要がある。スケーリングが不要でディスプレイ出力に直接対応するセンタリングモードはデフォルトで列挙される。
pNumModes : [int] 型: UINT* pDesc を NULL に設定すると、pNumModes はフォーマットとオプションに一致するディスプレイモードの数を返す。それ以外の場合、pNumModes は pDesc に返されたディスプレイモードの数を返す。
pDesc : [var] 型: DXGI_MODE_DESC* ディスプレイモードのリストへのポインタ (DXGI_MODE_DESC を参照)。ディスプレイモードの数を取得するには NULL に設定する。

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

解説

要求されたフォーマットとその他の入力オプションに一致するディスプレイモードを取得する。(IDXGIOutput.GetDisplayModeList)

[戻り値]
型: HRESULT 次の DXGI_ERROR
のいずれかを返す。このメソッドの呼び出し直後に利用可能なディスプレイモードが変更される場合があり、その場合は
DXGI_ERROR_MORE_DATA が返される
(すべてのディスプレイモードを格納する十分な領域がない場合)。GetDisplayModeList がリモートデスクトップサービス
(旧称ターミナルサービス) セッションから呼び出された場合、DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
が返される。

[備考]

一般的に、ウィンドウモードからフルスクリーンモードに切り替えるとき、スワップチェーンはスワップチェーンの解像度、色深度、リフレッシュレートを満たす
(またはそれを上回る) ディスプレイモードを自動的に選択する。ディスプレイモードをより細かく制御するには、この API
を使用してモニタの能力に対して検証されたディスプレイモードのセット、またはデスクトップに一致するすべてのモードを取得する
(デスクトップ設定がモニタに対して検証されない場合)。示されているとおり、この API は 2
回呼び出されるように設計されている。最初に利用可能なモードの数を取得し、2 回目にモードの説明を返す。
（以下省略）

情報