Metode IDiscFormat2Erase::EraseMedia (imapi2.h)
Menghapus media dalam perekam disk aktif.
Sintaks
HRESULT EraseMedia();
Mengembalikan nilai
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:
Menampilkan kode | Deskripsi |
---|---|
|
Pointer tidak valid.
Nilai: 0x80004003 |
|
Kegagalan yang tidak ditentukan.
Nilai: 0x80004005 |
|
Gagal mengalokasikan memori yang diperlukan.
Nilai: 0x8007000E |
|
Perangkat gagal menerima perintah dalam periode waktu habis. Ini mungkin disebabkan oleh perangkat yang telah memasuki status tidak konsisten, atau nilai batas waktu untuk perintah mungkin perlu ditingkatkan.
Nilai: 0xC0AA020D |
|
Perangkat melaporkan data yang tidak terduga atau tidak valid untuk perintah.
Nilai: 0xC0AA02FF |
|
Media dimasukkan terbalik.
Nilai: 0xC0AA0204 |
|
Drive melaporkan bahwa itu sedang dalam proses menjadi siap. Silakan coba lagi permintaan ini nanti.
Nilai: 0xC0AA0205 |
|
Tidak ada media di perangkat.
Nilai: 0xC0AA0202 |
|
Media saat ini sedang diformat. Harap tunggu hingga format selesai sebelum mencoba menggunakan media.
Nilai: 0xC0AA0206 |
|
Drive melaporkan bahwa drive melakukan operasi jangka panjang, seperti menyelesaikan penulisan. Drive mungkin tidak dapat digunakan untuk jangka waktu yang lama.
Nilai: 0xC0AA0207 |
|
Penulisan gagal karena drive tidak menerima data dengan cukup cepat untuk melanjutkan penulisan. Memindahkan data sumber ke komputer lokal, mengurangi kecepatan tulis, atau mengaktifkan pengaturan "buffer underrun free" dapat mengatasi masalah ini.
Nilai: 0xC0AA0300 |
|
Media tidak kompatibel atau format fisik yang tidak diketahui.
Nilai: 0xC0AA0203 |
|
Struktur DVD tidak ada. Ini mungkin disebabkan oleh drive/medium yang tidak kompatibel yang digunakan.
Nilai: 0xC0AA020E |
|
Perangkat melaporkan bahwa halaman mode yang diminta (dan jenis) tidak ada.
Nilai: 0xC0AA0201 |
|
Drive melaporkan bahwa kombinasi parameter yang disediakan di halaman mode untuk perintah MODE SELECT tidak didukung.
Nilai: 0xC0AA0208 |
|
Kandar melaporkan bahwa media dilindungi terhadap penulisan.
Nilai: 0xC0AA0209 |
|
Kecepatan media tidak kompatibel dengan perangkat. Ini mungkin disebabkan oleh penggunaan media kecepatan yang lebih tinggi atau lebih rendah daripada rentang kecepatan yang didukung oleh perangkat.
Nilai: 0xC0AA020F |
|
Handel yang ditentukan tidak valid.
Nilai: 6 |
|
Sumber daya atau perangkat jaringan yang ditentukan tidak lagi tersedia.
Nilai: 55 |
|
Perangkat yang terkait dengan perekam ini selama operasi terakhir telah dikunci secara eksklusif, menyebabkan operasi ini gagal.
Nilai: 0xC0AA0210 |
|
Tipe media saat ini tidak didukung.
Nilai: 0xC0AA0909 |
|
Drive mengembalikan kesalahan untuk perintah START UNIT (spinup). Intervensi manual mungkin diperlukan.
Nilai: 0x80AA0908 |
|
Kandar tidak menyelesaikan penghapusan dalam satu jam. Drive mungkin memerlukan siklus daya, penghapusan media, atau intervensi manual lainnya untuk melanjutkan operasi yang tepat.
Catatan Saat ini, nilai ini juga akan dikembalikan jika upaya untuk melakukan penghapusan pada media CD-RW atau DVD-RW melalui antarmuka IDiscFormat2Erase gagal karena media menjadi buruk.
|
Keterangan
Menghapus media secara sinkron. Kemajuan dapat dilaporkan dengan memanggil peristiwa terdaftar jenis DDiscFormat2EraseEvents.
Sebelum memanggil metode ini, Anda harus memanggil metode berikut:
Anda juga harus mempertimbangkan untuk memanggil metode IDiscFormat2Erase::p ut_FullErase jika nilai defaultnya tidak sesuai untuk aplikasi Anda.Metode ini sinkron. Untuk menentukan kemajuan operasi penghapusan, Anda harus mengimplementasikan antarmuka DDiscFormat2EraseEvents . Untuk contoh yang menunjukkan cara mengimplementasikan penanganan aktivitas dalam skrip, lihat Memantau Kemajuan Dengan Peristiwa.
Saat ini, nilai E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR dikembalikan jika upaya untuk melakukan penghapusan pada media CD-RW atau DVD-RW melalui antarmuka IDiscFormat2Erase gagal karena media menjadi buruk atau kegagalan drive.
Persyaratan
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk