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