Fungsi D3DXSaveSurfaceToFile

Menyimpan permukaan ke file.

Sintaks

HRESULT D3DXSaveSurfaceToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DSURFACE9   pSrcSurface,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const RECT                 *pSrcRect
);

Parameter

pDestFile [in]

Jenis: LPCTSTR

Penunjuk ke string yang menentukan nama file gambar tujuan. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data string diselesaikan ke LPCSTR. Lihat Keterangan.

DestFormat [in]

Jenis: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT menentukan format file yang akan digunakan saat menyimpan. Fungsi ini mendukung penyimpanan ke semua format D3DXIMAGE_FILEFORMAT kecuali Portable Pixmap (.ppm) dan Targa/Truevision Graphics Adapter (.tga).

pSrcSurface [in]

Jenis: LPDIRECT3DSURFACE9

Arahkan ke antarmuka IDirect3DSurface9 , yang berisi gambar yang akan disimpan.

pSrcPalette [in]

Jenis: const PALETTEENTRY*

Pointer ke struktur PALETTEENTRY yang berisi palet 256 warna. Parameter ini bisa NULL.

pSrcRect [in]

Jenis: const RECT*

Penunjuk ke struktur RECT . Menentukan persegi sumber. Atur parameter ini ke NULL untuk menentukan seluruh gambar.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi berikut: D3DERR_INVALIDCALL

Keterangan

Pengaturan kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXSaveSurfaceToFileW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXSaveSurfaceToFileA karena string ANSI sedang digunakan.

Fungsi ini menangani konversi ke dan dari format tekstur terkompresi.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9

D3DXSaveTextureToFile

D3DXSaveVolumeToFile