D3DXSaveSurfaceToFile-Funktion
Speichert eine Oberfläche in einer Datei.
Syntax
HRESULT D3DXSaveSurfaceToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect
);
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).
-
pSrcSurface [in]
-
Typ: LPDIRECT3DSURFACE9
Zeiger auf die IDirect3DSurface9-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.
-
pSrcRect [in]
-
Typ: const RECT*
Zeiger auf eine RECT-Struktur . Gibt das Quellrechteck an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Image 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 D3DXSaveSurfaceToFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXSaveSurfaceToFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.
Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch