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介面的指標，代表要與紋理相關聯的裝置。

寬度 [in]

類型： UINT

以圖元為單位的寬度。 如果此值為 0，則會使用 1 的值。 請參閱＜備註＞。

高度 [in]

類型： UINT

高度以圖元為單位。 如果此值為 0，則會使用 1 的值。 請參閱＜備註＞。

MipLevels [in]

類型： UINT

要求的 mip 層級數目。 如果此值為零或D3DX_DEFAULT，則會建立完整的 mipmap 鏈結。

使用量 [in]

類型： DWORD

0、 D3DUSAGE_RENDERTARGET或 D3DUSAGE_DYNAMIC。 將此旗標設定為 D3DUSAGE_RENDERTARGET 表示介面是藉由呼叫 SetRenderTarget 方法做為轉譯目標。 如果指定 D3DUSAGE_RENDERTARGET 或 D3DUSAGE_DYNAMIC ，應用程式應該呼叫 CheckDeviceFormat來檢查裝置是否支援這項作業。 如需使用動態紋理的詳細資訊，請參閱 使用動態紋理。

格式 [in]

類型： D3DFORMAT

D3DFORMAT列舉類型的成員，描述紋理的要求像素格式。 如果裝置不支援要求的格式，傳回的紋理可能會與指定的格式不同。 應用程式應該檢查傳回紋理的格式，以查看其是否符合所要求的格式。

集 區 [in]

類型： 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 中的紋理函式