Microsoft DirectX 8.0 (Visual Basic)

D3DX8.CreateCubeTextureFromFileInMemory

メモリ内のファイルからキューブ テクスチャを作成する。

object.CreateCubeTextureFromFileInMemory( _ 
    Device As Direct3DDevice8, _ 
    SrcData As Any, _ 
    LengthInBytes As Long) As Direct3DCubeTexture8

パラメータ

object
D3DX8 オブジェクトを表すオブジェクト式。
Device
キューブ テクスチャに関連付けられたデバイスを表す、Direct3DDevice8 オブジェクト。
SrcData
キューブ テクスチャの作成に使用するメモリ内のファイル。「注意」を参照すること。
LengthInBytes
メモリ内のファイルのサイズ (バイト単位)。

戻り値

作成されたキューブ テクスチャを表す、Direct3DCubeTexture8 オブジェクト。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

この関数を使用して作成したリソースは、CONST_D3DPOOL 列挙型の D3DPOOL_MANAGED メンバで示されるメモリ クラスに配置される。

このメソッドは、アプリケーション定義のリソース (未加工データ) である、RT_RCDATA として格納されたイメージ ファイルをロードするために使用するように設計されている。それ以外の目的に使用すると、このメソッドは失敗する。

CreateCubeTextureFromFileInMemory は、DirectDrawSurface (DDS) ファイル フォーマットを使用する。DXTex ツールによって、ほかのファイル フォーマットからキューブ マップを生成し、それを DDS ファイル フォーマットで保存することができる。