Microsoft DirectX 8.0 (C++)

D3DXCreateVolumeTexture

必要に応じて呼び出しパラメータを調整し、空のボリューム テクスチャを作成する。

HRESULT D3DXCreateVolumeTexture(
  LPDIRECT3DDEVICE8 pDevice,
  UINT Width,
  UINT Height,
  UINT Depth,
  UINT MipLevels,
  DWORD Usage,
  D3DFORMAT Format,
  D3DPOOL Pool,
  LPDIRECT3DVOLUMETEXTURE8* ppVolumeTexture
);

パラメータ

pDevice
[in] ボリューム テクスチャに関連付けられるデバイスを表す IDirect3DDevice8 インターフェイスへのポインタ。
Width
[in] 幅 (ピクセル単位)。この値は 0 以外である必要がある。
Height
[in] 高さ (ピクセル単位)。この値は 0 以外である必要がある。
Depth
[in] 深度 (単位ピクセル)。この値は 0 以外である必要がある。
MipLevels
[in] 要求されるミップ レベルの数。この値が 0 または D3DX_DEFAULT の場合は、完全なミップマップ チェーンが作成される。
Usage
[in] 現時点では未使用なので 0 を設定しておく。
Format
[in] ボリューム テクスチャに対して要求されたピクセル フォーマットを記述する、D3DFORMAT 列挙型のメンバ。返されるボリューム テクスチャのフォーマットは Format で指定されたフォーマットと異なる場合がある。アプリケーションは、返されたボリューム テクスチャのフォーマットを確認する必要がある。
Pool
[in] ボリューム テクスチャの配置先となるメモリ クラスを記述する、D3DPOOL 列挙型のメンバ。
ppVolumeTexture
[out] 作成されたボリューム テクスチャ オブジェクトを表す IDirect3DVolumeTexture8 インターフェイスへのポインタのアドレス。

戻り値

成功した場合は D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DERR_INVALIDCALL
E_OUTOFMEMORY

注意

D3DXCreateVolumeTexture は、内部で D3DXCheckVolumeTextureRequirements を使用して呼び出しパラメータを調整する。したがって、IDirect3Ddevice8::CreateVolumeTexture の呼び出しが失敗する場合でも、D3DXCreateVolumeTexture の呼び出しは成功することが多い。

動作環境

  ヘッダー : D3dx8tex.h で宣言。
  インポート ライブラリ : D3dx8.lib を使用。