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 指定保存时要使用的文件格式。 此函数支持 保存到除 Portable Pixmap (.ppm) 和 Targa/Truevision Graphics Adapter (.tga) 以外的所有D3DXIMAGE_FILEFORMAT格式。
-
pSrcVolume [in]
-
指向 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 无法锁定位于视频内存中的非动态卷。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|
请参阅