D3DXCreateTexture
必要に応じて呼び出しパラメータを調整し、空のテクスチャを作成する。
HRESULT D3DXCreateTexture(
LPDIRECT3DDEVICE8 pDevice,
UINT Width,
UINT Height,
UINT MipLevels,
DWORD Usage,
D3DFORMAT Format,
D3DPOOL Pool,
LPDIRECT3DTEXTURE8* ppTexture
);
パラメータ
- pDevice
- [in] テクスチャに関連付けられているデバイスを表す IDirect3DDevice8 インターフェイスへのポインタ。
- Width
- [in] 幅 (ピクセル単位)。この値は 0 以外である必要がある。
- Height
- [in] 高さ (ピクセル単位)。この値は 0 以外である必要がある。
- MipLevels
- [in] 要求されるミップ レベルの数。この値が 0 または D3DX_DEFAULT の場合は、完全なミップマップ チェーンが作成される。
- Usage
- [in] 0 または D3DUSAGE_RENDERTARGET。このフラグに D3DUSAGE_RENDERTARGET を設定すると、そのサーフェスはレンダリング ターゲットとして使用されることを示す。リソースは、SetRenderTarget メソッドの pNewRenderTarget パラメータに渡すことができる。D3DUSAGE_RENDERTARGET を指定する場合、アプリケーションは IDirect3D8::CheckDeviceFormat を呼び出して、デバイスがこれらの処理をサポートしていることを確認する必要がある。
- Format
- [in] テクスチャに対して要求されたピクセル フォーマットを記述する D3DFORMAT 列挙型のメンバ。返されるテクスチャのフォーマットは Format で指定されたフォーマットと異なる場合がある。アプリケーションは、返されたテクスチャのフォーマットを確認する必要がある。
- Pool
- [in] テクスチャの配置先となるメモリ クラスを記述する、D3DPOOL 列挙型のメンバ。
- ppTexture
- [out] 作成されたテクスチャ オブジェクトを表す、IDirect3DTexture8 インターフェイスへのポインタのアドレス。
戻り値
成功した場合は D3D_OK を返す。
失敗した場合は、次のいずれかの値を返す。
注意
D3DXCreateTexture は、内部で D3DXCheckTextureRequirements を使用して呼び出しパラメータを調整する。したがって、IDirect3Ddevice8::CreateTexture の呼び出しが失敗する場合でも、D3DXCreateTexture の呼び出しは成功することが多い。
ヘッダー : D3dx8tex.h で宣言。
インポート ライブラリ : D3dx8.lib を使用。