D3DXSaveSurfaceToFileInMemory 函数

将图面保存到图像文件。

语法

HRESULT D3DXSaveSurfaceToFileInMemory(
  _Out_       LPD3DXBUFFER         *ppDestBuf,
  _In_        D3DXIMAGE_FILEFORMAT DestFormat,
  _In_        LPDIRECT3DSURFACE9   pSrcSurface,
  _In_  const PALETTEENTRY         *pSrcPalette,
  _In_  const RECT                 *pSrcRect
);

parameters

ppDestBuf [out]

类型: LPD3DXBUFFER*

指向将存储图像的 ID3DXBuffer 的指针的地址。

DestFormat [in]

类型: D3DXIMAGE_FILEFORMAT

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

pSrcSurface [in]

类型: LPDIRECT3DSURFACE9

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

pSrcPalette [in]

类型: const PALETTEENTRY*

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

pSrcRect [in]

类型: const RECT*

指向 RECT 结构的指针。 指定源矩形。 将此参数设置为 NULL 以指定整个映像。

返回值

类型: HRESULT

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

备注

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

要求

要求
标头
D3dx9tex.h

D3dx9.lib

请参阅

D3DX 9 中的纹理函数

D3DXSaveVolumeToFileInMemory