Platform SDK: DirectX

IDirectDraw7::GetDisplayMode

IDirectDraw7::GetDisplayMode メソッドは、現在のディスプレイ モードを取得する。

HRESULT GetDisplayMode(
  LPDDSURFACEDESC2 lpDDSurfaceDesc2  
);

パラメータ

lpDDSurfaceDesc2
サーフェスの記述を格納する DDSURFACEDESC2 構造体のアドレス。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_UNSUPPORTEDMODE

注意

アプリケーションがこのメソッドで返された情報をあらかじめ保存して、クリーンアップの際のディスプレイ モードのリストアとして利用することは望ましくない。アプリケーションでは、IDirectDraw7::RestoreDisplayMode メソッドを使用して、クリーンアップの際にモードをリストアする必要がある。これにより、マルチプロセス環境で発生することがある競合を回避できる。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDraw7::SetDisplayModeIDirectDraw7::RestoreDisplayModeIDirectDraw7::EnumDisplayModes