D3DX11SaveTextureToFile-Funktion
Hinweis
Die Hilfsprogrammbibliothek D3DX (D3DX 9, D3DX 10 und D3DX 11) ist für Windows 8 veraltet und wird für Windows Store Apps nicht unterstützt.
Hinweis
Anstatt diese Funktion zu verwenden, wird empfohlen, die DirectXTex-Bibliothek CaptureTexture und dann SaveToXXXFile (wobei XXX WIC, DDS oder TGA ist) zu verwenden. WIC unterstützt DDS und TGA nicht. D3DX 9 unterstützte TGA als gängiges Art-Source-Format für Spiele). Für das vereinfachte Szenario der Erstellung eines Screenshots aus einer Renderzieltextur wird empfohlen, die DirectXTK-Bibliothek SaveDDSTextureToFile oder SaveWICTextureToFile zu verwenden.
Speichern Sie eine Textur in einer Datei.
Syntax
HRESULT D3DX11SaveTextureToFile(
ID3D11DeviceContext *pContext,
_In_ ID3D11Resource *pSrcTexture,
_In_ D3DX11_IMAGE_FILE_FORMAT DestFormat,
_In_ LPCTSTR pDestFile
);
Parameter
-
pContext
-
Typ: ID3D11DeviceContext*
Ein Zeiger auf ein ID3D11DeviceContext-Objekt.
-
pSrcTexture [ In]
-
Typ: ID3D11Resource*
Zeiger auf die zu speichernde Textur. Siehe ID3D11Resource.
-
DestFormat [ In]
-
Typ: D3DX11 _ IMAGE _ FILE _ FORMAT
Das Format, in dem die Textur gespeichert wird (siehe D3DX11 _ IMAGE _ FILE _ FORMAT). D3DX11 _ IFF _ DDS ist das bevorzugte Format, da es die einzige Option ist, die alle Formate im DXGI _ FORMATunterstützt.
-
pDestFile [ In]
-
Typ: LPCTSTR
Name der Zielausgabedatei, in der die Textur gespeichert wird. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Datentyp in LPCSTR aufgelöst.
Rückgabewert
Typ: HRESULT
Der Rückgabewert ist einer der In Direct3D 11-Rückgabecodes aufgeführtenWerte. verwenden Sie den Rückgabewert, um festzustellen, ob destFormat unterstützt wird.
Hinweise
D3DX11SaveTextureToFile schreibt die zusätzliche DDS _ HEADER _ DXT10-Struktur nur bei Bedarf für die Eingabetextur (z. B. weil die Eingabetextur im STANDARD-RGB-Format (sRGB) vorliegt). Wenn D3DX11SaveTextureToFile die DDS HEADER _ _ DXT10-Struktur schreibt, wird der dwFourCC-Member der DDS _ PIXELFORMAT-Struktur für die Textur auf DX10 festgelegt, um die Präsense des erweiterten Headers DDS _ HEADER _ DXT10 anzugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|