IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)
IOCTL_CDROM_SEND_OPC_INFORMATION 控制程式代碼可用於文件系統和其他想要事先執行最佳電源校正 (OPC) 程式的實作,因此第一個串流寫入不需要等待程式完成。 光學驅動器會執行 OPC 程式,以在寫入期間判斷鐳射的最佳功率。 程式是確保品質的必要程式,但它磨損媒體,不應該太頻繁地執行。
若要執行這項作業,請使用 IOCTL_CDROM_SEND_OPC_INFORMATION 呼叫 DeviceIoControl 函式作為 dwIoControlCode 參數。
主要程序代碼
輸入緩衝區
輸入緩衝區長度
輸出緩衝區
沒有。
輸出緩衝區長度
沒有。
狀態區塊
[資訊] 字段會設定為傳回的位元元組數。
由於來自其他 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) |