IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)
Код элемента управления IOCTL_CDROM_SEND_OPC_INFORMATION можно использовать в файловых системах и других реализациях, которые хотят выполнить процедуру оптимальной калибровки мощности (OPC) заранее, чтобы первая потоковая запись не должна ждать завершения процедуры. Оптический привод выполняет процедуру OPC, чтобы определить оптимальную мощность лазера во время записи. Процедура необходима для обеспечения качества, но она изнашивается носителей и не должна выполняться слишком часто.
Для выполнения этой операции вызовите функцию DeviceIoControl с IOCTL_CDROM_SEND_OPC_INFORMATION в качестве параметра dwIoControlCode .
Основной код
Входной буфер
Длина входного буфера
Длина CDROM_SIMPLE_OPC_INFO.
Выходной буфер
Нет.
Длина выходного буфера
Нет.
Блок состояния
В поле Сведения задано количество возвращаемых байтов.
Из-за распространения кода состояния из других API в поле Состояние можно задать (но не ограничивается) следующее:
STATUS_INFO_LENGTH_MISMATCH
Длина входного буфера меньше, чем требуется.
STATUS_INVALID_PARAMETER
Тип запроса — не SimpleOpcInfo.
STATUS_SUCCESS
Запрос успешно выполнен.
Комментарии
IOCTL IOCTL_CDROM_SEND_OPC_INFORMATION является оболочкой для команды SEND OPC INFORMATION спецификации MMC. Поля Exclude0 и Exclude1 напрямую сопоставляют поля SEND OPC INFORMATION с теми же именами.
При сбоях этот IOCTL возвращает стандартные ошибки, такие как STATUS_DEVICE_NOT_READY, STATUS_IO_TIMEOUT STATUS_IO_DEVICE_ERROR.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ntddcdrm.h (включая Winioctl.h) |