D3DXCreateVolumeTexture 函数

创建空卷纹理,根据需要调整调用参数。

语法

HRESULT D3DXCreateVolumeTexture(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  UINT                     Width,
  _In_  UINT                     Height,
  _In_  UINT                     Depth,
  _In_  UINT                     MipLevels,
  _In_  DWORD                    Usage,
  _In_  D3DFORMAT                Format,
  _In_  D3DPOOL                  Pool,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

参数

pDevice [in]

类型: LPDIRECT3DDEVICE9

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

宽度 [in]

类型: UINT

宽度(以像素为单位)。 此值必须是非零值。 驱动程序支持宽度、高度和深度) (的最大尺寸可以在 D3DCAPS9 的 MaxVolumeExtent 中找到。

高度 [in]

类型: UINT

高度(以像素为单位)。 此值必须是非零值。 驱动程序支持宽度、高度和深度) (的最大尺寸可以在 D3DCAPS9 的 MaxVolumeExtent 中找到。

深度 [in]

类型: UINT

深度(以像素为单位)。 此值必须是非零值。 驱动程序支持宽度、高度和深度) (的最大尺寸可以在 D3DCAPS9 的 MaxVolumeExtent 中找到。

MipLevels [in]

类型: UINT

请求的 mip 级别数。 如果此值为零或D3DX_DEFAULT,则会创建完整的 mipmap 链。

用法 [in]

类型: DWORD

0 或D3DUSAGE_DYNAMIC。 有关使用动态纹理的详细信息,请参阅 使用动态纹理

格式 [in]

类型: D3DFORMAT

D3DFORMAT 枚举类型的成员,描述卷纹理请求的像素格式。 返回的卷纹理的格式可能与 Format 指定的格式不同。 应用程序应检查返回的卷纹理的格式。

[in]

类型: D3DPOOL

D3DPOOL 枚举类型的成员,描述卷纹理应放置到其中的内存类。

ppVolumeTexture [out]

类型: LPDIRECT3DVOLUMETEXTURE9*

指向 IDirect3DVolumeTexture9 接口的指针的地址,表示创建的卷纹理对象。

返回值

类型: HRESULT

如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是下列值之一:D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL、E_OUTOFMEMORY。

备注

在内部,D3DXCreateVolumeTexture 使用 D3DXCheckVolumeTextureRequirements 来调整调用参数。 因此,对 D3DXCreateVolumeTexture 的调用通常会成功,其中 对 CreateVolumeTexture 的调用会失败。

要求

要求 Value
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DX 9 中的纹理函数