Microsoft DirectX 8.0 (Visual Basic)

D3DX8.CreateTextureFromFile

ファイルを元にしてテクスチャを作成する。

object.CreateTextureFromFile( _ 
    Device As Direct3DDevice8, _ 
    SrcFile As String) As Direct3DTexture8

指定項目

object
D3DX8 オブジェクトを表すオブジェクト式。
Device
テクスチャに関連付けられているデバイスを表す Direct3DDevice8 オブジェクト。
SrcFile
テクスチャの作成に使用するファイルを指定する String 値。

戻り値

作成されたテクスチャを表す Direct3DTexture8 オブジェクト。

エラー コード

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

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

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

注意

ミップマップされたテクスチャの各レベルには、ロードされたテクスチャが自動的に格納される。

ミップマップされたテクスチャにイメージをロードするとき、デバイスによっては、1x1 のイメージに変換できず、関数が失敗することがある。このような場合は、イメージを手動でロードする必要がある。

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