D3DXSaveVolumeToFile-Funktion

Speichert ein Volume in einer Datei auf dem Datenträger.

Syntax

HRESULT D3DXSaveVolumeToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DVOLUME9    pSrcVolume,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const D3DBOX               *pSrcBox
);

Parameter

pDestFile [in]

Typ: LPCTSTR

Zeiger auf eine Zeichenfolge, die den Dateinamen des Zielimages angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.

DestFormat [in]

Typ: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT , das beim Speichern zu verwendende Dateiformat anzugeben. Diese Funktion unterstützt das Speichern in allen D3DXIMAGE_FILEFORMAT Formaten außer Portable Pixmap (.ppm) und Targa/Truevision Graphics Adapter (.tga).

pSrcVolume [in]

Typ: LPDIRECT3DVOLUME9

Zeiger auf die IDirect3DVolume9-Schnittstelle , die das zu speichernde Bild enthält.

pSrcPalette [in]

Typ: const PALETTEENTRY*

Zeiger auf eine PALETTEENTRY-Struktur mit einer Palette von 256 Farben. Dieser Parameter kann NULL sein.

pSrcBox [in]

Typ: const D3DBOX*

Zeiger auf eine D3DBOX-Struktur . Gibt das Quellfeld an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Volume anzugeben.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert wie folgt aussehen: D3DERR_INVALIDCALL

Bemerkungen

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXSaveVolumeToFileW aufgelöst. Andernfalls wird der Funktionsaufruf in >D3DXSaveVolumeToFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.

Wenn das Volume nicht dynamisch ist (aufgrund eines Verwendungsparameters, der bei der Erstellung auf 0 festgelegt ist) und sich im Videospeicher befindet (der Speicherpool ist auf D3DPOOL_DEFAULT festgelegt), schlägt D3DXSaveTextureToFile fehl, da D3DX nicht dynamische Volumes im Videospeicher nicht sperren kann.

Anforderungen

Anforderung Wert
Header
D3dx9tex.h
Bibliothek
D3dx9.lib

Weitere Informationen

Texturfunktionen in D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory