Platform SDK: DirectX

D3DXGetVideoMode

D3DXGetVideoMode 関数は、このデバイスの特定のビデオ モードを記述する。

HRESULT D3DXGetVideoMode(
  DWORD deviceIndex,
  DWORD flags,
  DWORD modeIndex,
  D3DX_VIDMODEDESC* pModeList
); 

パラメータ

deviceIndex
デバイスを指定するインデックス値。このパラメータに D3DX_DEFAULT を指定すると、プライマリ サーフェスに関係のある最高のアクセラレート レベルに基づいてデバイスが指定される。
flags
このパラメータで D3DX_GVM_REFRESHRATE が設定されていない限り、リフレッシュ レートは無視される。リフレッシュ レートを無視させたい場合、このパラメータに 0 を設定する。
modeIndex
デバイスを指定する DWORD 値。インデックスは、0 で始まる。
pModeList
デバイスのディスプレイ モードの記述により返される D3DX_VIDMODEDESC 構造体へのポインタ。

戻り値

成功すれば、S_OK を返す。

失敗すれば、次いずれかの値を返す。

D3DXERR_D3DXNOTSTARTEDYET
D3DXERR_INITFAILED
D3DXERR_INVALIDD3DXDEVICEINDEX
D3DXERR_INVALIDPARAMETER
D3DXERR_NULLPOINTER

注意

D3DXGetVideoMode 関数により実行されるクエリは、ディスプレイ アダプタから DirectX へそのサポート内容を知らせるためのモード リストを指定するだけである。リストのすべてのビデオ モードについて D3DXCreateContext 関数や D3DXCreateContextEx 関数がうまく機能するとは保証されていない。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以上が必要。Windows 95 用に再配布可能な形で使用可能。
  バージョン : DirectX 7.0 が必要。
  ヘッダー : d3dxcore.h で宣言。
  ライブラリ : d3dx.lib を使用。

参照

D3DXGetMaxNumVideoModesD3DXGetMaxNumVideoModes