Platform SDK: DirectX

D3DXGetSurfaceFormat

D3DXGetSurfaceFormat 関数は、このデバイスでサポートされているサーフェス フォーマットのいずれかを記述する。

HRESULT D3DXGetSurfaceFormat(
  DWORD deviceIndex,
  D3DX_VIDMODEDESC* pDesc,
  DWORD surfClassFlags,
  DWORD surfaceIndex,
  D3DX_SURFACEFORMAT* pFormat
); 

パラメータ

deviceIndex
デバイスを指定するインデックス値。このパラメータに D3DX_DEFAULT を指定すると、プライマリ サーフェスに関係のある最高のアクセラレート レベルに基づいてデバイスが指定される。
pDesc
サポートされているサーフェス フォーマットが要求されたときのディスプレイ モードを記述した D3DX_VIDMODEDESC 構造体へのポインタ。このパラメータが NULL の場合、カレント ディスプレイ モードと見なされる。
surfClassFlags
サポートされたフォーマットが要求されているサーフェス クラスを示す D3DX_SURFACECLASS 列挙型のメンバ。
surfaceIndex
取得するサーフェス フォーマットを示す DWORD 値。インデックスは、0 で始まる。
pFormat
D3DX_SURFACEFORMAT 列挙型のメンバ (返されたサーフェス フォーマット) へのポインタ。

戻り値

成功すれば、S_OK を返す。

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

D3DXERR_D3DXNOTSTARTEDYET
D3DXERR_INITFAILED
D3DXERR_INVALIDD3DXDEVICEINDEX
D3DXERR_INVALIDPARAMETER
D3DXERR_NULLPOINTER

動作環境

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

参照

D3DXGetMaxSurfaceFormats