Fungsi D3DX11SaveTextureToFile

Catatan

Pustaka utilitas D3DX (D3DX 9, D3DX 10, dan D3DX 11) tidak digunakan lagi untuk Windows 8 dan tidak didukung untuk aplikasi Windows Store.

Catatan

Alih-alih menggunakan fungsi ini, kami sarankan Anda menggunakan pustaka DirectXTex , CaptureTexture lalu SaveToXXXFile (di mana XXX adalah WIC, DDS, atau TGA; WIC tidak mendukung DDS dan TGA; D3DX 9 mendukung TGA sebagai format sumber seni umum untuk game). Untuk skenario yang disederhanakan dalam membuat cuplikan layar dari tekstur target render, kami sarankan Anda menggunakan pustaka DirectXTK , SaveDDSTextureToFile atau SaveWICTextureToFile.

Simpan tekstur ke file.

Sintaks

HRESULT D3DX11SaveTextureToFile(
       ID3D11DeviceContext      *pContext,
  _In_ ID3D11Resource           *pSrcTexture,
  _In_ D3DX11_IMAGE_FILE_FORMAT DestFormat,
  _In_ LPCTSTR                  pDestFile
);

Parameter

pContext

Jenis: ID3D11DeviceContext*

Penunjuk ke objek ID3D11DeviceContext .

pSrcTexture [in]

Jenis: ID3D11Resource*

Arahkan ke tekstur yang akan disimpan. Lihat ID3D11Resource.

DestFormat [in]

Jenis: D3DX11_IMAGE_FILE_FORMAT

Format tekstur akan disimpan sebagai (lihat D3DX11_IMAGE_FILE_FORMAT). D3DX11_IFF_DDS adalah format yang disukai karena ini adalah satu-satunya opsi yang mendukung semua format dalam DXGI_FORMAT.

pDestFile [in]

Jenis: LPCTSTR

Nama file output tujuan tempat tekstur akan disimpan. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data diselesaikan ke LPCSTR.

Mengembalikan nilai

Jenis: HRESULT

Nilai yang dikembalikan adalah salah satu nilai yang tercantum dalam Direct3D 11 Return Codes; gunakan nilai yang dikembalikan untuk melihat apakah DestFormat didukung.

Keterangan

D3DX11SaveTextureToFile menulis struktur DDS_HEADER_DXT10 tambahan untuk tekstur input hanya jika perlu (misalnya, karena tekstur input dalam format RGB standar (sRGB). Jika D3DX11SaveTextureToFile menulis struktur DDS_HEADER_DXT10, D3DX11 Mengatur anggota dwFourCC dari struktur DDS_PIXELFORMAT untuk tekstur ke DX10 untuk menunjukkan presensi header DDS_HEADER_DXT10 diperluas.

Persyaratan

Persyaratan	Nilai
Header	D3DX11tex.h
Pustaka	D3DX11.lib

Lihat juga

Fungsi D3DX