Fungsi D3DXSaveVolumeToFile

Menyimpan volume ke file pada disk.

Sintaks

HRESULT D3DXSaveVolumeToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DVOLUME9    pSrcVolume,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const D3DBOX               *pSrcBox
);

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).

pSrcVolume [in]

Jenis: LPDIRECT3DVOLUME9

Arahkan ke antarmuka IDirect3DVolume9 yang berisi gambar yang akan disimpan.

pSrcPalette [in]

Jenis: const PALETTEENTRY*

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

pSrcBox [in]

Jenis: const D3DBOX*

Penunjuk ke struktur D3DBOX . Menentukan kotak sumber. Atur parameter ini ke NULL untuk menentukan seluruh volume.

Nilai kembali

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 D3DXSaveVolumeToFileW. Jika tidak, panggilan fungsi menyelesaikan ke >D3DXSaveVolumeToFileA karena string ANSI sedang digunakan.

Fungsi ini menangani konversi ke dan dari format tekstur terkompresi.

Jika volume nondinamis (karena parameter penggunaan yang diatur ke 0 pada pembuatan) dan terletak di memori video (kumpulan memori diatur ke D3DPOOL_DEFAULT), D3DXSaveTextureToFile akan gagal karena D3DX tidak dapat mengunci volume nondinamika yang terletak di memori video.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory