Funzione D3DXSaveSurfaceToFile

Salva una superficie in un file.

Sintassi

HRESULT D3DXSaveSurfaceToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DSURFACE9   pSrcSurface,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const RECT                 *pSrcRect
);

Parametri

pDestFile [in]

Tipo: LPCTSTR

Puntatore a una stringa che specifica il nome file dell'immagine di destinazione. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.

DestFormat [in]

Tipo: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT specificare il formato di file da utilizzare durante il salvataggio. Questa funzione supporta il salvataggio in tutti i formati D3DXIMAGE_FILEFORMAT ad eccezione di Portable Pixmap (.ppm) e Targa/Truevision Graphics Adapter (.tga).

pSrcSurface [in]

Tipo: LPDIRECT3DSURFACE9

Puntatore all'interfaccia IDirect3DSurface9 contenente l'immagine da salvare.

pSrcPalette [in]

Tipo: const PALETTEENTRY*

Puntatore a una struttura PALETTEENTRY contenente una tavolozza di 256 colori. Questo parametro può essere NULL.

pSrcRect [in]

Tipo: const RECT*

Puntatore a una struttura RECT . Specifica il rettangolo di origine. Impostare questo parametro su NULL per specificare l'intera immagine.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere il seguente: D3DERR_INVALIDCALL

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se è definito Unicode, la chiamata di funzione viene risolta in D3DXSaveSurfaceToFileW. In caso contrario, la chiamata di funzione viene risolta in D3DXSaveSurfaceToFileA perché vengono usate stringhe ANSI.

Questa funzione gestisce la conversione da e verso formati di trama compressi.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9

D3DXSaveTextureToFile

D3DXSaveVolumeToFile