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

要求された形式とその他の入力オプションに一致する表示モードを取得します。

構文

HRESULT GetDisplayModeList1(
                  DXGI_FORMAT     EnumFormat,
                  UINT            Flags,
  [in, out]       UINT            *pNumModes,
  [out, optional] DXGI_MODE_DESC1 *pDesc
);

パラメーター

EnumFormat

色書式の DXGI_FORMAT型指定された値。

Flags

ビットごとの OR 演算を使用して結合される DXGI_ENUM_MODES型指定された値の組み合わせ。 結果の値は、含める表示モードのオプションを指定します。 スケーリングを必要とする表示モードを公開するには、DXGI_ENUM_MODES_SCALINGを指定する必要があります。 スケーリングを必要とせず、表示出力に直接対応する中央揃えモードは、既定で列挙されます。

[in, out] pNumModes

pDesc が指すメモリ ブロックで GetDisplayModeList1 が返す表示モードの数を受け取る変数へのポインター。 pDesc を NULL に設定して、pNumModes が形式とオプションに一致する表示モードの数を返すようにします。 それ以外の場合、 pNumModes はpDesc で返される表示モードの数を返します。

[out, optional] pDesc

表示モードのリストへのポインター。表示モードの数を取得するには 、NULL に設定します。

戻り値

DXGI_ERRORトピックで説明されているエラー コードの 1 つを返します。 このメソッドを呼び出した直後に使用可能な表示モードが変更されることはまれですが、可能です。その場合、DXGI_ERROR_MORE_DATAが返されます (すべての表示モードに十分な空きがない場合)。

注釈

GetDisplayModeList1 が GetDisplayModeList から更新され、 DXGI_MODE_DESC1 構造体の一覧が返されます。これは、モードの説明が更新されます。 GetDisplayModeList はGetDisplayModeList1 を呼び出すかのように動作します。 GetDisplayModeList は、ステレオ モードを含め、 DXGI_ENUM_MODESによって指定されたすべてのモードを返すことができるためです。 ただし、 GetDisplayModeList は、以前のモードの説明であり、ステレオ モードを示さない DXGI_MODE_DESC 構造体の一覧を返します。

GetDisplayModeList1 メソッドは、Flags パラメーターでDXGI_ENUM_MODES_STEREO フラグを指定しない限り、ステレオ モードを列挙しません。 DXGI_ENUM_MODES_STEREOを指定すると、 pDesc パラメーターが指す返されるモードの一覧にステレオ モードが含まれます。 つまり、 メソッドはステレオ モードとモノラル モードの両方を返します。

一般に、ウィンドウモードから全画面表示モードに切り替えると、スワップチェーンは、スワップチェーンの解像度、色深度、リフレッシュレートを満たす(または超える)表示モードを自動的に選択します。 表示モードをより細かく制御するには、 GetDisplayModeList1 を使用して、モニター機能に対して検証される一連の表示モード、またはデスクトップに一致するすべてのモード (デスクトップ設定がモニターに対して検証されていない場合) をポーリングします。

次のコード例は、 GetDisplayModeList1 を 2 回呼び出す必要があることを示しています。 最初に GetDisplayModeList1 を呼び出して使用可能なモードの数を取得し、2 番目 に GetDisplayModeList1 を呼び出してモードの説明を返します。

UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags         = DXGI_ENUM_MODES_INTERLACED;

pOutput->GetDisplayModeList1( format, flags, &num, 0);

...

DXGI_MODE_DESC1 * pDescs = new DXGI_MODE_DESC1[num];
pOutput->GetDisplayModeList1( format, flags, &num, pDescs);
      

要件

こちらもご覧ください

IDXGIOutput1