次の方法で共有


IDirect3DDevice9::CreateVolumeTexture メソッド (d3d9.h)

ボリューム テクスチャ リソースを作成します。

構文

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

パラメーター

[in] Width

型: UINT

ボリューム テクスチャの最上位レベルの幅 (ピクセル単位)。 D3DCAPS9のD3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが 設定されている場合 、この値は 2 の累乗である必要があります。 後続のレベルのピクセル ディメンションは、前のレベルのピクセル ディメンションの半分の切り捨てられた値になります (個別)。 各次元は1ピクセルのサイズで締め金で止める。 したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。 ドライバーがサポートする最大ディメンション (幅、高さ、深さ) は、 D3DCAPS9の MaxVolumeExtent にあります。

[in] Height

型: UINT

ボリューム テクスチャの最上位レベルの高さ (ピクセル単位)。 D3DCAPS9のD3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが 設定されている場合 、この値は 2 の累乗である必要があります。 後続のレベルのピクセル ディメンションは、前のレベルのピクセル ディメンションの半分の切り捨てられた値になります (個別)。 各次元は1ピクセルのサイズで締め金で止める。 したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。 ドライバーがサポートする最大ディメンション (幅、高さ、深さ) は、 D3DCAPS9の MaxVolumeExtent にあります。

[in] Depth

型: UINT

ボリューム テクスチャの最上位レベルの深度 (ピクセル単位)。 D3DCAPS9のD3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが 設定されている場合 、この値は 2 の累乗である必要があります。 後続のレベルのピクセル ディメンションは、前のレベルのピクセル ディメンションの半分の切り捨てられた値になります (個別)。 各次元は1ピクセルのサイズで締め金で止める。 したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。 ドライバーがサポートする最大ディメンション (幅、高さ、深さ) は、 D3DCAPS9の MaxVolumeExtent にあります。

[in] Levels

型: UINT

テクスチャ内のレベルの数。 この値が 0 の場合、Direct3D は、mipmapped ボリューム テクスチャをサポートするハードウェアに対して、1x1 ピクセルまでのすべてのテクスチャ サブレベルを生成します。 IDirect3DBaseTexture9::GetLevelCount を呼び出して、生成されたレベルの数を確認します。

[in] Usage

型: DWORD

使用量には 0 を指定できます。これは、使用量の値がないことを示します。 使用が必要な場合は、D3DUSAGE_DYNAMICまたはD3DUSAGE_SOFTWAREPROCESSINGを使用します。 詳細については、「 D3DUSAGE」を参照してください。

[in] Format

種類: D3DFORMAT

D3DFORMAT列挙型のメンバー。ボリューム テクスチャ内のすべてのレベルの形式を記述します。

[in] Pool

種類: D3DPOOL

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

[out, retval] ppVolumeTexture

種類: IDirect3DVolumeTexture9**

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

[in] pSharedHandle

型: HANDLE*

予約済み。 このパラメーターを NULL に設定 します。 このパラメーターは、Windows Vista 用 Direct3D 9 で リソースを共有するために使用できます。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

要件

要件
対象プラットフォーム Windows
ヘッダー d3d9.h (D3D9.h を含む)
Library D3D9.lib

こちらもご覧ください

D3DXCreateVolumeTexture

D3DXCreateVolumeTextureFromFile

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResource

D3DXCreateVolumeTextureFromResourceEx

IDirect3DDevice9