Antarmuka IWriteEngine2 (imapi2.h)

Artikel
08/24/2023

Gunakan antarmuka ini untuk menulis aliran data ke perangkat.

Antarmuka ini harus digunakan oleh dukungan pengembangan untuk jenis atau format media baru. Menulis ke media biasanya mencakup langkah-langkah berikut:

Menyiapkan perangkat keras dengan mengatur halaman mode untuk media.
Mengkueri perangkat keras untuk memverifikasi bahwa media cukup besar.
Menginisialisasi tulisan, misalnya, dengan memformat media atau mengatur OPC.
Melakukan perintah WRITE yang sebenarnya.
Menyelesaikan penulisan dengan menghentikan pemformatan atau menutup sesi atau trek.

Saat mengembangkan dukungan untuk jenis media baru, Anda dapat menerapkan langkah 1, 2, 3, dan 5, dan menggunakan antarmuka ini untuk melakukan langkah 4. Perhatikan bahwa semua antarmuka IDiscFormat2* menggunakan antarmuka ini untuk melakukan operasi tulis.

Sebagian besar aplikasi klien harus menggunakan antarmuka IDiscFormat2Data untuk menulis gambar ke perangkat.

Untuk membuat instans antarmuka ini, panggil fungsi CoCreateInstance . Use__uuidof(MsftWriteEngine2) untuk pengidentifikasi kelas dan __uuidof(IWriteEngine2) untuk pengidentifikasi antarmuka.

Warisan

Antarmuka IWriteEngine2 mewarisi dari antarmuka IDispatch . IWriteEngine2 juga memiliki jenis anggota ini:

Metode

Antarmuka IWriteEngine2 memiliki metode ini.


IWriteEngine2::CancelWrite Membatalkan operasi tulis yang sedang berlangsung.
IWriteEngine2::get_BytesPerSector Mengambil jumlah byte yang akan digunakan untuk setiap sektor selama penulisan. Nilai yang dikembalikan menunjukkan nilai yang sebelumnya ditetapkan dengan IWriteEngine2::p ut_BytesPerSector, dan tidak mengembalikan byte saat ini per nilai sektor untuk media.
IWriteEngine2::get_EndingSectorsPerSecond Mengambil perkiraan jumlah sektor per detik yang dapat ditulis perangkat perekaman ke media di akhir proses penulisan.
IWriteEngine2::get_Recorder Mengambil perangkat perekaman untuk digunakan dalam operasi tulis.
IWriteEngine2::get_StartingSectorsPerSecond Mengambil perkiraan jumlah sektor per detik yang dapat ditulis perangkat perekaman ke media pada awal proses penulisan.
IWriteEngine2::get_UseStreamingWrite12 Mengambil nilai yang menunjukkan apakah operasi tulis menggunakan perintah WRITE12 atau WRITE10.
IWriteEngine2::get_WriteInProgress Mengambil nilai yang menunjukkan apakah perekam sedang menulis data ke disk.
IWriteEngine2::p ut_BytesPerSector Mengatur jumlah byte yang akan digunakan untuk setiap sektor selama penulisan.
IWriteEngine2::p ut_EndingSectorsPerSecond Mengatur perkiraan jumlah sektor per detik yang dapat ditulis perangkat perekaman ke media di akhir proses penulisan.
IWriteEngine2::p ut_Recorder Mengatur perangkat perekaman untuk operasi tulis.
IWriteEngine2::p ut_StartingSectorsPerSecond Mengatur perkiraan jumlah sektor per detik yang dapat ditulis perangkat perekaman ke media pada awal proses penulisan.
IWriteEngine2::p ut_UseStreamingWrite12 Mengatur nilai yang menunjukkan apakah operasi tulis menggunakan perintah WRITE12 atau WRITE10.
IWriteEngine2::WriteSection Menulis aliran data ke perekam saat ini.

Keterangan

Untuk membuat objek MsftWriteEngine2 dalam skrip, gunakan IMAPI2. MsftWriteEngine2 sebagai pengidentifikasi program saat memanggil CreateObject.

Dimungkinkan bagi transisi status daya untuk terjadi selama operasi pembakaran (yaitu log-off pengguna atau sistem ditangguhkan) yang menyebabkan gangguan proses pembakaran dan kemungkinan kehilangan data. Untuk pertimbangan pemrograman, lihat Mencegah Keluar atau Menangguhkan Selama Pembakaran.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi2.h