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
D3DX11tex.h
Bibliothek
D3DX11.lib

Siehe auch

D3DX-Funktionen