Share via

IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)

  • Статья

Код элемента управления IOCTL_CDROM_SEND_OPC_INFORMATION можно использовать в файловых системах и других реализациях, которые хотят выполнить процедуру оптимальной калибровки мощности (OPC) заранее, чтобы первая потоковая запись не должна ждать завершения процедуры. Оптический привод выполняет процедуру OPC, чтобы определить оптимальную мощность лазера во время записи. Процедура необходима для обеспечения качества, но она изнашивается носителей и не должна выполняться слишком часто.

Для выполнения этой операции вызовите функцию DeviceIoControl с IOCTL_CDROM_SEND_OPC_INFORMATION в качестве параметра dwIoControlCode .

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

CDROM_SIMPLE_OPC_INFO

Длина входного буфера

Длина 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)

См. также раздел

CDROM_SIMPLE_OPC_INFO

DeviceIoControl

IOCTL_CDROM_SEND_OPC_INFORMATION