Funzione D3DXSaveVolumeToFile
Salva un volume in un file su disco.
Sintassi
HRESULT D3DXSaveVolumeToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DVOLUME9 pSrcVolume,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox
);
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).
-
pSrcVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Puntatore all'interfaccia IDirect3DVolume9 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.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Puntatore a una struttura D3DBOX . Specifica la casella di origine. Impostare questo parametro su NULL per specificare l'intero volume.
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 D3DXSaveVolumeToFileW. In caso contrario, la chiamata di funzione viene risolta in >D3DXSaveVolumeToFileA perché vengono usate stringhe ANSI.
Questa funzione gestisce la conversione da e verso formati di trama compressi.
Se il volume non è fluido (a causa di un parametro di utilizzo impostato su 0 alla creazione) e si trova nella memoria video (il pool di memoria impostato su D3DPOOL_DEFAULT), D3DXSaveTextureToFile avrà esito negativo perché D3DX non può bloccare i volumi non dinamiche presenti nella memoria video.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche