D3DXSaveVolumeToFile 函数

  • 项目

将卷保存到磁盘上的文件。

语法

HRESULT D3DXSaveVolumeToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DVOLUME9    pSrcVolume,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const D3DBOX               *pSrcBox
);

parameters

pDestFile [in]

类型： LPCTSTR

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

DestFormat [in]

类型： D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT 指定保存时要使用的文件格式。 此函数支持 保存到除 Portable Pixmap (.ppm) 和 Targa/Truevision Graphics Adapter (.tga) 以外的所有D3DXIMAGE_FILEFORMAT格式。

pSrcVolume [in]

类型： LPDIRECT3DVOLUME9

指向 IDirect3DVolume9 接口的指针，其中包含要保存的图像。

pSrcPalette [in]

类型： const PALETTEENTRY*

指向 PALETTEENTRY 结构的指针，该结构包含 256 种颜色的调色板。 此参数可以为 NULL。

pSrcBox [in]

类型： const D3DBOX*

指向 D3DBOX 结构的指针。 指定源框。 将此参数设置为 NULL 以指定整个卷。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值：D3DERR_INVALIDCALL

备注

编译器设置还确定函数版本。 如果定义了 Unicode，则函数调用将解析为 D3DXSaveVolumeToFileW。 否则，函数调用将解析为 >D3DXSaveVolumeToFileA，因为使用的是 ANSI 字符串。

此函数处理与压缩纹理格式的转换。

如果卷由于使用参数在创建) 设置为 0 而 (且位于视频内存中， (内存池设置为 D3DPOOL_DEFAULT) ， 则 D3DXSaveTextureToFile 将失败，因为 D3DX 无法锁定位于视频内存中的非动态卷。

要求

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

请参阅

D3DX 9 中的纹理函数

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory