D3DXCheckCubeTextureRequirements 函数

检查 cube-texture-creation 参数。

语法

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

参数

pDevice [in]

类型: LPDIRECT3DDEVICE9

指向 IDirect3DDevice9 接口的指针,表示要与多维数据集纹理关联的设备。

pSize [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_NOTAVAILABLE、D3DERR_INVALIDCALL。

备注

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

立方体纹理与其他表面的不同之处在于,它们是表面的集合。 若要使用立方体纹理调用 SetRenderTarget ,必须使用 GetCubeMapSurface 选择单个人脸,并将生成的表面传递给 SetRenderTarget

要求

要求
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DX 9 中的纹理函数