IDirect3DDevice9::CreateTexture メソッド (d3d9helper.h)

[アーティクル]
02/26/2024

テクスチャリソースを作成します。

構文

HRESULT CreateTexture(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          UINT              Levels,
  [in]          DWORD             Usage,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DTexture9 **ppTexture,
  [in]          HANDLE            *pSharedHandle
);

パラメーター

[in] Width

型: UINT

テクスチャの最上位レベルの幅 (ピクセル単位)。後続のレベルのピクセルディメンションは、前のレベルのピクセル次元の半分の切り捨てられた値になります (独立)。各次元は1ピクセルのサイズで締め金で止める。したがって、2 による除算の結果が 0 の場合、代わりに 1 が取られます。

[in] Height

型: UINT

テクスチャの最上位レベルの高さ (ピクセル単位)。後続のレベルのピクセルディメンションは、前のレベルのピクセル次元の半分の切り捨てられた値になります (独立)。各次元は1ピクセルのサイズで締め金で止める。したがって、2 による除算の結果が 0 の場合、代わりに 1 が取られます。

[in] Levels

型: UINT

テクスチャ内のレベルの数。ゼロの場合、Direct3D は、mipmapped テクスチャをサポートするハードウェアに対して、1 x 1 ピクセルまでのすべてのテクスチャサブレベルを生成します。 IDirect3DBaseTexture9::GetLevelCount を呼び出して、生成されたレベルの数を確認します。

[in] Usage

種類: DWORD

使用量には 0 を指定できます。これは、使用量の値がないことを示します。ただし、使用が必要な場合は、1 つ以上の D3DUSAGE 定数の組み合わせを使用します。 usage パラメーターと IDirect3D9::CreateDevice の動作フラグを照合することをお勧めします。

[in] Format

種類: D3DFORMAT

テクスチャ内のすべてのレベルの形式を記述する、 D3DFORMAT 列挙型のメンバー。

[in] Pool

種類: D3DPOOL

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

[out, retval] ppTexture

種類: IDirect3DTexture9**

作成されたテクスチャリソースを表す IDirect3DTexture9 インターフェイスへのポインター。

[in] pSharedHandle

型: HANDLE*

予約済み。このパラメーターを NULL に設定 します。このパラメーターは、Direct3D 9 for Windows Vista でリソースを共有するために使用できます。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

注釈

アプリケーションは、IDirect3D9::CheckDeviceFormat を呼び出して、特定の形式の Mipmaps (Direct3D 9) の自動生成のサポートを検出D3DUSAGE_AUTOGENMIPMAP。 IDirect3D9::CheckDeviceFormat がD3DOK_NOAUTOGENを返した場合、IDirect3DDevice9::CreateTexture は成功しますが、1 レベルのテクスチャを返します。

Windows Vista の CreateTexture では、システムメモリポインターからテクスチャを作成し、システムメモリの使用、割り当て、削除に対するアプリケーションの柔軟性を高めることができます。たとえば、アプリケーションは GDI システムメモリビットマップポインターを渡し、その周囲に Direct3D テクスチャインターフェイスを取得できます。 CreateTexture でシステムメモリポインターを使用する場合、次の制限があります。

テクスチャのピッチは、幅にピクセルあたりのバイト数を乗算した値と等しい必要があります。
1 つのミップマップレベルを持つテクスチャのみがサポートされます。 Levels 引数は 1 である必要があります。
Pool 引数はD3DPOOL_SYSTEMMEMする必要があります。
pSharedHandle 引数は、システムメモリポイントを保持できるバッファーへの有効なポインターである必要があります。*pSharedHandle は、テクスチャ幅のバイト単位のサイズ * テクスチャの高さ * テクスチャ形式のピクセルあたりのバイト数を持つシステムメモリへの有効なポインターである必要があります。