Metode IDiscMaster::RecordDisc (imapi.h)

Membakar gambar bertahap ke media dalam perekam cakram aktif.

Sintaks

HRESULT RecordDisc(
  [in] boolean bSimulate,
  [in] boolean bEjectAfterBurn
);

Parameter

[in] bSimulate

Menunjukkan apakah media dibakar. Jika parameter ini TRUE, media dalam perekam disk aktif sebenarnya tidak dibakar. Sebaliknya, pembakaran yang disimulasikan dilakukan. Simulasi adalah pengujian yang baik dari perekam disk, karena sebagian besar operasi dilakukan seperti dalam luka bakar nyata. Jika parameter ini FALSE, maka media di perekam benar-benar dibakar.

[in] bEjectAfterBurn

Menunjukkan apakah akan mengeluarkan media setelah pembakaran. Jika parameter ini TRUE, media dikeluarkan. Jika parameter ini FALSE, media tidak dikeluarkan.

Nilai kembali

S_OK dikembalikan pada keberhasilan, tetapi kode keberhasilan lainnya dapat dikembalikan sebagai hasil dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Keterangan

Metode ini kembali ketika pembakaran selesai, meskipun panggilan balik kemajuan dilakukan jika terdaftar dengan metode ProgressAdvise . Kesalahan apa pun menyebabkan metode ini kembali, dengan sedikit atau tanpa tindakan korektif pada bagian dari metode ini.

Data gambar bertahap tidak valid setelah panggilan ke RecordDisc. Ini memungkinkan aplikasi untuk melakukan pembakaran media yang disimulasikan atau aktual. Untuk keamanan, konten file simpanan dibersihkan secara otomatis setelah berhasil menyelesaikan panggilan pertama ke metode ini. Cakram harus diisi ulang untuk membakarnya lagi.

Metode RecordDisc mengharapkan untuk bekerja dengan media kosong untuk audio. Jika tidak, media mungkin perlu dihapus (misalnya, media CD-RW dalam drive CD-RW). Lihat IDiscRecorder::Erase.

Metode SetActiveDiscRecorder menentukan apakah ada disk multi-sesi IMAPI di drive aktif saat pengaturan. Jika demikian, IMAPI masuk ke mode multi-sesi secara otomatis. Jika dalam mode multi-sesi dan panggilan dilakukan ke RecordDisc, disk yang sama dengan mode multi-sesi harus berada di perekam aktif atau kode kesalahan IMAPI_E_WRONGDISC akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi.h
Pustaka	Uuid.lib
DLL	Actxprxy.dll

Lihat juga

IDiscMaster