D3DXCreateVolumeTextureFromFileInMemory

  • [アーティクル]

メモリー内のファイルからボリューム テクスチャーを作成します。

HRESULT 
D3DXCreateVolumeTextureFromFileInMemory(
  LPDIRECT3DDEVICE9 pDevice,
  LPCVOID pSrcFile,
  UINT SrcData,
  LPDIRECT3DVOLUMETEXTURE9 ppVolumeTexture
);

パラメータ

  • pDevice
    IDirect3DDevice9 インターフェイスへのポインターです。ボリューム テクスチャーに関連付けられるデバイスを示します。
  • pSrcFile
    ボリューム テクスチャーの作成に使用するメモリー内のファイルへのポインターです。
  • SrcData
    メモリー内のサイズ (バイト単位) です。
  • ppVolumeTexture
    作成するテクスチャー オブジェクトを表す IDirect3DVolumeTexture9 インターフェイスへのポインターのアドレスです。

戻り値

成功すると、D3D_OK を返します。失敗した場合は、次の戻り値のいずれかを返します。

D3DERR_NOTAVAILABLED3DERR_OUTOFVIDEOMEMORYD3DERR_INVALIDCALLD3DXERR_INVALIDDATAE_OUTOFMEMORY

解説　

この関数は、.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga ファイル形式をサポートします。「D3DXIMAGE_FILEFORMAT」を参照してください。

この関数は D3DXCreateVolumeTextureFromFileInMemoryEx(pDevice, pSrcFile, SrcData, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture) と同等です。

IDirect3DDevice9 オブジェクトからこの関数を呼び出してリソースを作成すると、そのリソースは D3DPOOL_MANAGED が示すメモリー クラスに格納されます。IDirect3DDevice9Ex オブジェクトからこのメソッドを呼び出した場合、作成したリソースは D3DPOOL_DEFAULT が示すメモリー クラスに配置されます。

このメソッドを使用して作成したテクスチャーには、自動的にフィルタリングが適用されます。このフィルタリングは D3DX_FILTER の D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER と同等です。

要件

ヘッダー: D3dx9tex.h 宣言

ライブラリ: D3dx9.lib 内容

関連項目

D3DXCreateVolumeTextureFromFile, D3DXCreateVolumeTextureFromFileEx, D3DXCreateVolumeTextureFromFileInMemoryEx, D3DXCreateVolumeTextureFromResource, D3DXCreateVolumeTextureFromResourceEx, D3DX 9 のテクスチャー関数