D3DXCreateCubeTextureFromFileInMemory 関数
D3DXCreateCubeTextureFromFileInMemory 関数
メモリ内のファイルからキューブ テクスチャを作成する。
構文
HRESULT D3DXCreateCubeTextureFromFileInMemory(
LPDIRECT3DDEVICE9 pDevice,
LPCVOID pSrcData,
UINT SrcDataSize,
LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
パラメータ
- pDevice
[in] IDirect3DDevice9 インターフェイスへのポインタ。キューブ テクスチャに関連付けられるデバイスを表す。 - pSrcData
[in] キューブマップの作成に使うメモリ内のファイルへのポインタ。「注意」を参照すること。 - SrcDataSize
[in] メモリ内のファイルのサイズ (バイト単位)。 - ppCubeTexture
[out] 作成されたキューブ テクスチャ オブジェクトを表す、IDirect3DCubeTexture9 インターフェイスへのポインタのアドレス。
戻り値
成功した場合は、D3D_OK を返す。
失敗した場合は、次のいずれかの値を返す。
| D3DERR_INVALIDCALL | メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。 |
| D3DERR_NOTAVAILABLE | このデバイスは、照会されたテクニックをサポートしていない。 |
| D3DERR_OUTOFVIDEOMEMORY | Microsoft® Direct3D® が処理を行うのに十分なディスプレイ メモリがない。 |
| D3DXERR_INVALIDDATA | データが無効である。 |
| E_OUTOFMEMORY | Direct3D が呼び出しを完了するための十分なメモリを割り当てることができなかった。 |
注意
この関数がサポートしている ファイル フォーマットは、.bmp、.dds、.dib、.jpg、.png、および .tga である。
この関数を使って作成したリソースは、D3DPOOL_MANAGED で示されるメモリ クラスに配置される。
このメソッドは、アプリケーション定義のリソース (未加工データ) である、RT_RCDATA として格納されたイメージ ファイルをロードするために使うように設計されている。それ以外の目的に使うと、このメソッドは失敗する。
D3DXCreateCubeTextureFromFileInMemory は、DirectDraw® サーフェイス (DDS) ファイル フォーマットを使う。DXTex ツールによって、他のファイル フォーマットからキューブ マップを生成し、それを DDS ファイル フォーマットで保存することができる。
関数の情報
| ヘッダー | d3dx9tex.h |
| インポート ライブラリ | d3dx9.lib |
| 最低限のオペレーティング システム | Windows 98 |
参照