Metode IDiscFormat2Data::SetWriteSpeed (imapi2.h)
Mengatur kecepatan tulis perekam disk.
Sintaks
HRESULT SetWriteSpeed(
[in] LONG RequestedSectorsPerSecond,
[in] VARIANT_BOOL RotationTypeIsPureCAV
);
Parameter
[in] RequestedSectorsPerSecond
Kecepatan tulis yang diminta diukur dalam sektor disk per detik.
Nilai 0xFFFFFFFF (-1) meminta penulisan terjadi menggunakan kecepatan tercepat yang didukung untuk media. Ini adalah default.
[in] RotationTypeIsPureCAV
Jenis kontrol kecepatan rotasi yang diminta. Atur ke VARIANT_TRUE untuk meminta jenis kontrol kecepatan rotasi kecepatan sudut konstan (CAV). Atur ke VARIANT_FALSE untuk menggunakan jenis kontrol kecepatan rotasi lain yang didukung perekam. Defaultnya adalah VARIANT_FALSE.
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:
| Menampilkan kode | Deskripsi |
|---|---|
|
Permintaan memerlukan perekam diska saat ini untuk dipilih.
Nilai: 0xC0AA0003 |
|
Satu atau beberapa argumen tidak valid.
Nilai: 0x80070057 |
|
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 |
|
Penulisan gagal karena drive mengembalikan informasi kesalahan yang tidak dapat dipulihkan.
Nilai: 0xC0AA0301 |
|
Jenis rotasi yang diminta tidak didukung oleh drive dan jenis rotasi disesuaikan.
Nilai: 0x00AA0005 |
|
Kecepatan tulis yang diminta tidak didukung oleh drive dan kecepatan disesuaikan.
Nilai: 0x00AA0004 |
|
Kecepatan tulis dan jenis rotasi yang diminta tidak didukung oleh drive dan keduanya disesuaikan.
Nilai: 0x00AA0006 |
Keterangan
Metode ini mengatur kecepatan tulis dan jenis kontrol kecepatan rotasi untuk perekam. Nilai yang diminta mungkin berbeda dari nilai yang ditetapkan dalam perekam. Untuk menentukan perekam, panggil metode IDiscFormat2Data::p ut_Recorder .
Jika perekam mendukung kecepatan tulis yang diminta, perangkat disk menggunakan nilai yang diminta. Jika perekam tidak mendukung kecepatan tulis yang diminta, perekam menggunakan kecepatan tulis yang didukungnya yang paling dekat dengan nilai yang diminta. Properti IDiscFormat2Data::get_CurrentWriteSpeed berisi nilai yang digunakan oleh perekam.
Untuk mengambil daftar kecepatan tulis yang didukung perekam dan media saat ini, panggil metode IDiscFormat2Data::get_SupportedWriteSpeeds .
Jika Anda meminta kecepatan sudut konstan (CAV) untuk jenis kontrol kecepatan rotasi dan perekam tidak mendukung CAV, perangkat disk menggunakan jenis kontrol kecepatan rotasi lain yang didukungnya. Properti IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV menunjukkan nilai yang digunakan oleh perekam.
Untuk mengambil nilai yang diminta, panggil metode IDiscFormat2Data::get_RequestedWriteSpeed dan IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV .
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
IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV
IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV