IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)
IOCTL_CDROM_SEND_OPC_INFORMATION控制程式代碼可用於文件系統和其他想要事先執行最佳電源校正 (OPC) 程式的實作,讓第一個串流寫入不需要等待程式完成。 光學磁碟驅動器會執行 OPC 程式,以判斷寫入期間雷射的最佳能力。 這是確保品質的必要程式,但它會損除媒體,不應該太頻繁地執行。
若要執行這項作業,請使用 IOCTL_CDROM_SEND_OPC_INFORMATION 作為 dwIoControlCode 參數呼叫 DeviceIoControl 函式。
主要程序代碼
輸入緩衝區
輸入緩衝區長度
輸出緩衝區
無。
輸出緩衝區長度
無。
狀態區塊
[ 資訊] 位元位會設定為傳回的位元組數目。
由於來自其他 API 的狀態代碼傳播,[ 狀態 ] 欄位可以設定為 [ (但不限於下列) :
STATUS_INFO_LENGTH_MISMATCH
輸入緩衝區長度小於必要。
STATUS_INVALID_PARAMETER
要求類型不是 SimpleOpcInfo。
STATUS_SUCCESS
要求已順利完成。
備註
IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL 是 MMC 規格之 SEND OPC INFORMATION 命令的包裝函式。 Exclude0 和 Exclude1 欄位會直接對應至具有相同名稱的 SEND OPC INFORMATION 字段。
失敗時,此 IOCTL 會傳回標準錯誤,例如STATUS_DEVICE_NOT_READY、STATUS_IO_TIMEOUT STATUS_IO_DEVICE_ERROR。
規格需求
需求 | 值 |
---|---|
標頭 | ntddcdrm.h (包含 Winioctl.h) |