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 auflösen. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR auflösen. Siehe Hinweise.
-
DestFormat [ In]
-
D3DXIMAGE _ FILEFORMAT gibt das Dateiformat an, das beim Speichern verwendet werden soll. Diese Funktion unterstützt das Speichern in allen D3DXIMAGE _ FILEFORMAT-Formaten mit Ausnahme von 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, die eine Palette von 256 Farben enthält. 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, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert wie folgt sein: D3DERR _ INVALIDCALL
Hinweise
Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXSaveVolumeToFileW auflösen. Andernfalls wird der Funktionsaufruf in >D3DXSaveVolumeToFileA,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), kann _ D3DXSaveTextureToFile nicht gesperrt werden, da D3DX nicht dynamische Volumes im Videospeicher sperren kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|