D3DXCreateTexture 関数

空のテクスチャを作成し、必要に応じて呼び出し元のパラメーターを調整します。

構文

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

テクスチャに関連付けるデバイスを表す IDirect3DDevice9 インターフェイスへのポインター。

Width [in]

型: UINT

幅 (ピクセル単位)。 この値が 0 の場合は、値 1 が使用されます。 「解説」を参照してください。

高さ [入力]

型: UINT

高さ (ピクセル単位)。 この値が 0 の場合は、値 1 が使用されます。 「解説」を参照してください。

MipLevels [in]

型: UINT

要求されたミップ レベルの数。 この値が 0 またはD3DX_DEFAULTの場合は、完全なミップマップ チェーンが作成されます。

使用法 [入力]

種類: DWORD

0、 D3DUSAGE_RENDERTARGET、または D3DUSAGE_DYNAMIC。 このフラグを D3DUSAGE_RENDERTARGET に設定すると、 SetRenderTarget メソッドを呼び出して、サーフェスがレンダー ターゲットとして使用されることを示します。 D3DUSAGE_RENDERTARGETまたはD3DUSAGE_DYNAMICが指定されている場合、アプリケーションは CheckDeviceFormat を呼び出して、デバイスがこの操作をサポートしていることをチェックする必要があります。 動的テクスチャの使用の詳細については、「動的テクスチャの 使用」を参照してください。

書式 [in]

型: D3DFORMAT

テクスチャの要求されたピクセル形式を記述する D3DFORMAT 列挙型のメンバー。 デバイスが要求された形式をサポートしていない場合、返されるテクスチャの形式が指定とは異なる場合があります。 アプリケーションは、返されたテクスチャの形式をチェックして、要求された形式と一致するかどうかを確認する必要があります。

プール [入力]

種類: D3DPOOL

テクスチャを配置するメモリ クラスを記述する D3DPOOL 列挙型のメンバー。

ppTexture [out]

種類: LPDIRECT3DTEXTURE9*

作成されたテクスチャ オブジェクトを表す IDirect3DTexture9 インターフェイスへのポインターのアドレス。

戻り値

種類: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は、D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORYのいずれかになります。

解説

内部的には、D3DXCreateTexture は D3DXCheckTextureRequirements を使用して呼び出し元のパラメーターを調整します。 したがって、D3DXCreateTexture の呼び出しは、 CreateTexture の呼び出しが失敗する場合に成功することがよくあります。

Height と Width の両方が D3DX_DEFAULTに設定されている場合、両方のパラメーターに 256 の値が使用されます。 Height または Width が D3DX_DEFAULT に設定され、もう一方のパラメーターが数値に設定されている場合、テクスチャは高さと幅の両方が数値と等しい正方形になります。

要件

要件	値
ヘッダー	D3dx9tex.h
ライブラリ	D3dx9.lib

関連項目

D3DX 9 のテクスチャ関数