D3DXCreateVolumeTextureFromFile 函数

从文件创建卷纹理。

语法

HRESULT D3DXCreateVolumeTextureFromFile(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  LPCTSTR                  pSrcFile,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

parameters

pDevice [in]

类型: LPDIRECT3DDEVICE9

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

pSrcFile [in]

类型: LPCTSTR

指向指定文件名的字符串的指针。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,字符串数据类型解析为 LPCSTR。 请参阅“备注”。

ppVolumeTexture [out]

类型: LPDIRECT3DVOLUMETEXTURE9*

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

返回值

类型: HRESULT

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

注解

编译器设置还确定函数版本。 如果定义了 Unicode,函数调用将解析为 D3DXCreateVolumeTextureFromFileW。 否则,函数调用将解析为 D3DXCreateVolumeTextureFromFileA,因为正在使用 ANSI 字符串。

该函数等效于 D3DXCreateVolumeTextureFromFileEx (pDevice、pSrcFile、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、 NULLNULL、ppVolumeTexture) 。

此函数支持以下文件格式:.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 请参阅 D3DXIMAGE_FILEFORMAT

Mipmapped 纹理会自动填充已加载的纹理的每个级别。

将图像加载到被误用的纹理中时,某些设备无法转到 1x1 图像,此函数将失败。 如果发生这种情况,则需要手动加载映像。

请注意,从 IDirect3DDevice9 对象调用时使用此函数创建的资源将放置在由D3DPOOL_MANAGED表示的内存类中。 从 IDirect3DDevice9Ex 对象调用此方法时,资源将放置在由D3DPOOL_DEFAULT表示的内存类中。

筛选会自动应用于使用此方法创建的纹理。 筛选等效于D3DX_FILTER_TRIANGLE |D3DX_FILTER中的 D3DX_FILTER_DITHER

要求

要求 Value
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResource

D3DXCreateVolumeTextureFromResourceEx

D3DX 9 中的纹理函数