Metode IDirectXFile::CreateSaveObject

Membuat objek penyimpanan. Dihentikan.

Sintaks

HRESULT CreateSaveObject(
  [in]          LPCSTR                  szFileName,
  [in]          DXFILEFORMAT            dwFileFormat,
  [out, retval] LPDIRECTXFILESAVEOBJECT *ppSaveObj
);

Parameter

szFileName [in]

Jenis: LPCSTR

Arahkan ke nama file yang akan digunakan untuk menyimpan data.

dwFileFormat [in]

Jenis: DXFILEFORMAT

Menunjukkan format yang akan digunakan saat menyimpan file DirectX. Nilai ini bisa menjadi salah satu bendera DXFILEFORMAT_xxx di Konstanta DXFILE. Untuk informasi selengkapnya, lihat Keterangan.

ppSaveObj [out, retval]

Jenis: LPDIRECTXFILESAVEOBJECT*

Alamat penunjuk ke antarmuka IDirectXFileSaveObject , mewakili objek penyimpanan yang dibuat.

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah DXFILE_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: DXFILEERR_BADALLOC, DXFILEERR_BADFILE, DXFILEERR_BADVALUE.

Keterangan

Setelah menggunakan metode ini, gunakan metode antarmuka IDirectXFileSaveObject untuk membuat objek data dan untuk menyimpan templat atau data.

Nilai default untuk format file adalah DXFILEFORMAT_BINARY. Nilai format file dapat digabungkan dalam OR logis untuk membuat teks terkompresi atau file biner terkompresi. Jika file ditentukan sebagai biner (0) dan teks (1), file tersebut akan disimpan sebagai file teks karena nilainya tidak akan dapat dibedakan dari nilai format file teks (0 + 1 = 1). Jika Anda menunjukkan bahwa format file harus berupa teks dan dikompresi, file pertama-tama akan ditulis sebagai teks lalu dikompresi. Namun, file teks terkompresi tidak seefisien file teks biner, jadi dalam banyak kasus Anda akan ingin menunjukkan biner dan terkompresi. Mengatur file yang akan dikompresi tanpa menentukan format akan menghasilkan file biner terkompresi.

Persyaratan

Persyaratan	Nilai
Header	DXFile.h
Pustaka	D3dxof.lib

Lihat juga

IDirectXFile

IDirectXFileSaveObject