IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)
Kode kontrol IOCTL_CDROM_SEND_OPC_INFORMATION dapat digunakan dalam sistem file dan implementasi lain yang ingin melakukan prosedur Optimum Power Calibration (OPC) terlebih dahulu, sehingga penulisan streaming pertama tidak harus menunggu prosedur selesai. Drive optik melakukan prosedur OPC untuk menentukan kekuatan laser optimal selama penulisan. Prosedur ini diperlukan untuk memastikan kualitas, tetapi aus media dan tidak boleh dilakukan terlalu sering.
Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan IOCTL_CDROM_SEND_OPC_INFORMATION sebagai parameter dwIoControlCode .
Kode utama
Buffer input
Panjang buffer input
Panjang CDROM_SIMPLE_OPC_INFO.
Buffer output
Tidak ada.
Panjang buffer output
Tidak ada.
Blok status
Bidang Informasi diatur ke jumlah byte yang dikembalikan.
Karena penyebaran kode status dari API lain, bidang Status dapat diatur ke (tetapi tidak terbatas pada) hal berikut:
STATUS_INFO_LENGTH_MISMATCH
Panjang buffer input lebih kecil dari yang diperlukan.
STATUS_INVALID_PARAMETER
Jenis permintaan bukan SimpleOpcInfo.
STATUS_SUCCESS
Permintaan berhasil diselesaikan.
Keterangan
IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL adalah pembungkus atas perintah SEND OPC INFORMATION dari spesifikasi MMC. Bidang Kecualikan0 dan Kecualikan1 langsung dipetakan ke bidang KIRIM INFORMASI OPC dengan nama yang sama.
Pada kegagalan, IOCTL ini mengembalikan kesalahan standar, seperti STATUS_DEVICE_NOT_READY, STATUS_IO_TIMEOUT, STATUS_IO_DEVICE_ERROR.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | ntddcdrm.h (termasuk Winioctl.h) |