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 |
|
| Pustaka |
|
Lihat juga