共用方式為


IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)

IOCTL_CDROM_SEND_OPC_INFORMATION控制程式代碼可用於文件系統和其他想要事先執行最佳電源校正 (OPC) 程式的實作,讓第一個串流寫入不需要等待程式完成。 光學磁碟驅動器會執行 OPC 程式,以判斷寫入期間雷射的最佳能力。 這是確保品質的必要程式,但它會損除媒體,不應該太頻繁地執行。

若要執行這項作業,請使用 IOCTL_CDROM_SEND_OPC_INFORMATION 作為 dwIoControlCode 參數呼叫 DeviceIoControl 函式。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

CDROM_SIMPLE_OPC_INFO

輸入緩衝區長度

CDROM_SIMPLE_OPC_INFO的長度。

輸出緩衝區

無。

輸出緩衝區長度

無。

狀態區塊

[ 資訊] 位元位會設定為傳回的位元組數目。

由於來自其他 API 的狀態代碼傳播,[ 狀態 ] 欄位可以設定為 [ (但不限於下列) :

STATUS_INFO_LENGTH_MISMATCH

輸入緩衝區長度小於必要。

STATUS_INVALID_PARAMETER

要求類型不是 SimpleOpcInfo

STATUS_SUCCESS

要求已順利完成。

備註

IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL 是 MMC 規格之 SEND OPC INFORMATION 命令的包裝函式。 Exclude0Exclude1 欄位會直接對應至具有相同名稱的 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