次の方法で共有

IDirect3DDevice9::CreateVolumeTexture

  • [アーティクル]

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

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

パラメータ

  • Width
    最上位のボリューム テクスチャーの幅 (ピクセル単位)。D3DCAPS9 の D3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが設定されている場合、この値は 2 の累乗でなければなりません。以降のレベルでのピクセルのサイズは、1 つ上のレベルのピクセルのサイズを (個別に) 1/2 した値になります。それぞれのサイズは、1 ピクセルのサイズに収められます。したがって、2 で除算した結果が 0 の場合、代わりに 1 が使用されます。ドライバーがサポートする最大サイズ (幅、高さ、奥行き) は、D3DCAPS9 の MaxVolumeExtent で指定されます。
  • Height
    最上位のボリューム テクスチャーの高さ (ピクセル単位)。D3DCAPS9 の D3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが設定されている場合、この値は 2 の累乗でなければなりません。以下の各レベルでのピクセルのサイズは、1 つ上のレベルのピクセルのサイズをそれぞれ個別に 1/2 とした値になります。それぞれのサイズは、1 ピクセルのサイズに収められます。したがって、2 で除算した結果が 0 の場合、代わりに 1 が使用されます。ドライバーがサポートする最大サイズ (幅、高さ、奥行き) は、D3DCAPS9 の MaxVolumeExtent で指定されます。
  • Depth
    最上位のボリューム テクスチャーの奥行き (ピクセル単位)。D3DCAPS9 の D3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが設定されている場合、この値は 2 の累乗でなければなりません。以下の各レベルでのピクセルのサイズは、1 つ上のレベルのピクセルのサイズをそれぞれ個別に 1/2 とした値になります。それぞれのサイズは、1 ピクセルのサイズに収められます。したがって、2 で除算した結果が 0 の場合、代わりに 1 が使用されます。ドライバーがサポートする最大サイズ (幅、高さ、奥行き) は、D3DCAPS9 の MaxVolumeExtent で指定されます。
  • Levels
    テクスチャー内のレベル数。この値がゼロの場合、Direct3D は、ミップマップ ボリューム テクスチャーをサポートするハードウェアに対して、各面の 1x1 ピクセルまでのすべてのテクスチャー サブレベルを生成します。生成されるレベルの数を確認するには、IDirect3DBaseTexture9::GetLevelCount を呼び出します。
  • Usage
    使用法には 0 を指定できます。これは使用法の値がないことを示します。使用法が必要な場合は、D3DUSAGE_DYNAMIC または D3DUSAGE_SOFTWAREPROCESSING を使用します。詳細については、「D3DUSAGE」を参照してください。
  • Format
    D3DFORMAT 列挙型のメンバー。ボリューム テクスチャー内のすべてのレベルのフォーマットを指定します。
  • Pool
    D3DPOOL 列挙型のメンバーです。ボリューム テクスチャーを配置するメモリー クラスを示します。
  • ppVolumeTexture
    作成されたボリューム テクスチャー リソースを示す IDirect3DVolumeTexture9 インターフェイスへのポインターのアドレスです。
  • pSharedHandle
    予約済みです。このパラメーターを NULL に設定します。このパラメーターを Windows Vista の Direct3D 9 で使用して、リソースを共有することができます。

戻り値

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

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

D3DXCreateVolumeTexture, D3DXCreateVolumeTextureFromFile, D3DXCreateVolumeTextureFromFileEx, D3DXCreateVolumeTextureFromFileInMemory, D3DXCreateVolumeTextureFromFileInMemoryEx, D3DXCreateVolumeTextureFromResource, D3DXCreateVolumeTextureFromResourceEx