Metode IDiscRecorder2Ex::GetModePage (imapi2.h)
Mengambil halaman mode yang ditentukan dari perangkat.
Sintaks
HRESULT GetModePage(
[in] IMAPI_MODE_PAGE_TYPE requestedModePage,
[in] IMAPI_MODE_PAGE_REQUEST_TYPE requestType,
[out] BYTE **modePageData,
[out] ULONG_IMAPI2_MODE_PAGE *byteSize
);
Parameter
[in] requestedModePage
Halaman mode untuk diambil. Untuk nilai yang mungkin, lihat jenis enumerasi IMAPI_MODE_PAGE_TYPE .
[in] requestType
Jenis data halaman mode yang akan diambil, misalnya, pengaturan saat ini atau pengaturan yang mengaktifkan penulisan. Untuk nilai yang mungkin, lihat jenis enumerasi IMAPI_MODE_PAGE_REQUEST_TYPE .
[out] modePageData
Buffer data yang berisi halaman mode. Untuk detail konten buffer data, lihat perintah MODE SENSE (10) dalam revisi terbaru spesifikasi MMC pada ftp://ftp.t10.org/t10/drafts/mmc5.
Metode ini menghapus informasi header dan data non-halaman lainnya sebelum mengembalikan buffer.
Setelah selesai, panggil fungsi CoTaskMemFree untuk membebaskan memori.
[out] byteSize
Ukuran, dalam byte, dari buffer data modePageData .
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 |
---|---|
|
Satu atau beberapa argumen tidak valid.
Nilai: 0x80070057 |
|
Penunjuk 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 disisipkan terbalik.
Nilai: 0xC0AA0204 |
|
Drive melaporkan bahwa itu sedang dalam proses menjadi siap. Silakan coba permintaan lagi 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 ia 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 tak dikenal.
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 |
|
Perangkat melaporkan bahwa halaman mode yang diminta (dan jenis) tidak ada.
Nilai: 0xC0AA0201 |
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
IDiscRecorder2Ex::GetSupportedModePages
IMAPI_MODE_PAGE_TYPE