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。 请参阅“备注”。

高度 [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 中的纹理函数