D3DXCheckTextureRequirements 函数

  • 项目

检查纹理创建参数。

语法

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

parameters

pDevice [in]

类型： LPDIRECT3DDEVICE9

指向 IDirect3DDevice9 接口的指针，表示要与纹理关联的设备。

pWidth [in， out]

类型： UINT*

指向请求的宽度（以像素为单位）或 NULL 的指针。 返回更正后的大小。

pHeight [in， out]

类型： UINT*

指向请求的高度（以像素为单位）或 NULL 的指针。 返回更正后的大小。

pNumMipLevels [in， out]

类型： UINT*

指向请求的 mipmap 级别数的指针，或 NULL。 返回已更正的 mipmap 级别数。

用法 [in]

类型： DWORD

0 或 D3DUSAGE_RENDERTARGET。 将此标志设置为D3DUSAGE_RENDERTARGET表示表面将用作呈现目标。 然后，可以将资源传递给 SetRenderTarget 方法的 pNewRenderTarget 参数。 如果指定了D3DUSAGE_RENDERTARGET，应用程序应通过调用 CheckDeviceFormat 检查设备支持此操作。

pFormat [in， out]

类型： D3DFORMAT*

指向 D3DFORMAT 枚举类型的成员的指针。 指定所需的像素格式或 NULL。 返回更正后的格式。

池 [in]

类型： D3DPOOL

D3DPOOL 枚举类型的成员，描述应放置纹理的内存类。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值之一：D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE。

备注

如果此函数的参数无效，此函数将返回更正的参数。

将请求的要求与可用格式进行比较时，此函数使用以下启发式：

  • 请勿选择通道数较少的格式。
  • 除非显式请求，否则请避免 使用 FOURCC 和 24 位格式。
  • 尽量不要添加新频道。
  • 尽量不要更改每个通道的位数。
  • 尽量避免在格式类型之间转换。 例如，避免将 ARGB 格式转换为深度格式。

要求

要求 值
标头
D3dx9tex.h
库
D3dx9.lib

请参阅

D3DX 9 中的纹理函数