IDirect3D9Ex::GetAdapterModeCountEx メソッド (d3d9.h)

使用可能な表示モードの数を返します。

構文

UINT GetAdapterModeCountEx(
  [in] UINT                       Adapter,
  [in] const D3DDISPLAYMODEFILTER *pFilter
);

[in] Adapter

型: UINT

表示モード数を取得するディスプレイアダプターを示す序数。

[in] pFilter

目的の表示モードの特性を指定します。「D3DDISPLAYMODEFILTER」を参照してください。

型: UINT

使用可能な表示モードの数。このメソッドからの値 0 の戻り値は、このような表示モードがサポートされていないか、単にこのモニターが使用できなくなったことを示しています。

同じハードウェアの他のヘッドでの表示モードの変更、モニターの変更またはその接続状態の変更、デスクトップ拡張機能/拡張解除などのイベントはすべて、使用可能な表示モードの数に影響する可能性があります。

全画面表示アプリケーションでは、 PresentEx または CheckDeviceState から返されるS_PRESENT_MODE_CHANGEDは、これらのイベントによる表示モード設定の失敗を示します。

現在使用可能な表示モードを正常に設定する可能性を高めるために、全画面表示アプリケーションは、S_PRESENT_MODE_CHANGEDの受信時に使用可能な表示モードリストの再クエリを試行する必要があります。