D3DXSaveSurfaceToFileInMemory 函式

發行項
06/13/2023

將表面儲存至影像檔案。

語法

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

參數

ppDestBuf [out]

類型： LPD3DXBUFFER*

將儲存影像之 ID3DXBuffer 指標的位址。

DestFormat [in]

類型： D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT 指定儲存時要使用的檔案格式。此函式支援儲存到所有 D3DXIMAGE_FILEFORMAT 格式，但可攜式 Pixmap (.ppm) 和 Targa/Truevision Graphics Adapter (.tga) 除外。

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