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
);

parameters

pDevice [in]

类型： LPDIRECT3DDEVICE9

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

Width [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 的调用会失败。

要求

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

请参阅

D3DX 9 中的纹理函数