D3DXCreateVolumeTexture 関数

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

構文

HRESULT D3DXCreateVolumeTexture(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  UINT                     Width,
  _In_  UINT                     Height,
  _In_  UINT                     Depth,
  _In_  UINT                     MipLevels,
  _In_  DWORD                    Usage,
  _In_  D3DFORMAT                Format,
  _In_  D3DPOOL                  Pool,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

ボリューム テクスチャに関連付けるデバイスを表す IDirect3DDevice9 インターフェイスへのポインター。

Width [in]

型: UINT

幅 (ピクセル単位)。 この値は 0 以外である必要があります。 ドライバーがサポートする最大ディメンション (幅、高さ、奥行き) は、 D3DCAPS9 の MaxVolumeExtent にあります。

高さ [入力]

型: UINT

高さ (ピクセル単位)。 この値は 0 以外である必要があります。 ドライバーがサポートする最大ディメンション (幅、高さ、奥行き) は、 D3DCAPS9 の MaxVolumeExtent にあります。

深さ [入力]

型: UINT

深度 (ピクセル単位)。 この値は 0 以外である必要があります。 ドライバーがサポートする最大ディメンション (幅、高さ、奥行き) は、 D3DCAPS9 の MaxVolumeExtent にあります。

MipLevels [in]

型: UINT

要求されたミップ レベルの数。 この値が 0 またはD3DX_DEFAULTの場合は、完全なミップマップ チェーンが作成されます。

使用法 [入力]

種類: DWORD

0 またはD3DUSAGE_DYNAMIC。 動的テクスチャの使用の詳細については、「動的テクスチャの 使用」を参照してください。

書式 [in]

型: D3DFORMAT

ボリューム テクスチャの要求されたピクセル形式を記述する D3DFORMAT 列挙型のメンバー。 返されるボリューム テクスチャの形式は、Format で指定された形式とは異なる場合があります。 アプリケーションでは、返されるボリューム テクスチャの形式をチェックする必要があります。

プール [入力]

種類: D3DPOOL

ボリューム テクスチャを配置するメモリ クラスを記述する D3DPOOL 列挙型のメンバー。

ppVolumeTexture [out]

種類: LPDIRECT3DVOLUMETEXTURE9*

作成されたボリューム テクスチャ オブジェクトを表す IDirect3DVolumeTexture9 インターフェイスへのポインターのアドレス。

戻り値

種類: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL、E_OUTOFMEMORYのいずれかになります。

解説

内部的には、D3DXCreateVolumeTexture は D3DXCheckVolumeTextureRequirements を使用して呼び出し元のパラメーターを調整します。 そのため、多くの場合、D3DXCreateVolumeTexture の呼び出しは 、CreateVolumeTexture の呼び出しが失敗する場合に成功します。

必要条件

要件	値
ヘッダー	D3dx9tex.h
ライブラリ	D3dx9.lib

関連項目

D3DX 9 のテクスチャ関数