D3DXCheckCubeTextureRequirements 函数

检查多维数据集纹理创建参数。

语法

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

要求

要求 Value
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DX 9 中的纹理函数