IDirect3D9Ex::GetAdapterDisplayModeEx メソッド (d3d9.h)
アダプターの現在の表示モードと回転設定を取得します。
構文
HRESULT GetAdapterDisplayModeEx(
[in] UINT Adapter,
[in, out] D3DDISPLAYMODEEX *pMode,
[in, out] D3DDISPLAYROTATION *pRotation
);
パラメーター
[in] Adapter
型: UINT
照会するディスプレイ アダプターを示す序数。 D3DADAPTER_DEFAULTは常にプライマリ ディスプレイ アダプターです。
[in, out] pMode
型: D3DDISPLAYMODEEX*
アダプターの表示モードに関するデータを含む D3DDISPLAYMODEEX 構造体へのポインター。 デバイスの表示モードとは対照的に、デバイスが全画面表示モードを所有していない場合はアクティブでない可能性があります。 NULL に設定できます。
[in, out] pRotation
アプリケーションが実行する画面回転の種類を示す D3DDISPLAYROTATION 構造体へのポインター。 このポインターを介して返される値は、 D3DPRESENTFLAG_NOAUTOROTATE フラグを使用する場合に重要です。それ以外の場合は、 NULL に設定できます。
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。
Adapter が範囲外の場合、または pMode が無効な場合、このメソッドはD3DERR_INVALIDCALLを返します。
解説
表示が 2:10:10:10 などの拡張形式の場合、GetAdapterDisplayModeEx は正しい形式を返しません。 代わりに、X8R8G8B8 という形式を返します。
ウィンドウ化されたアプリケーションでは、 PresentEx または CheckDeviceState から返S_PRESENT_MODE_CHANGED値は、表示モードが変更され、現在の表示モードの形式が異なる可能性があることを示します。 Present blt の色変換を回避するために、ウィンドウ化されたアプリケーションは、このメソッドを使用し、それに応じてスワップ チェーン形式を調整することで、必要に応じて新しい表示モード情報を取得できます。 このヘッドがデスクトップの一部でなくなった場合、またはモニターが切断されている場合、このメソッドはD3DERR_NOTAVAILABLEを返します。
要件
対象プラットフォーム | Windows |
ヘッダー | d3d9.h |
Library | D3D9.lib |