IOCTL_CDROM_GET_PERFORMANCE IOCTL (ntddcdrm.h)
從裝置擷取支援的速度。 IOCTL_CDROM_GET_PERFORMANCE I/O 控制件要求是 MMC 命令 GET PERFORMANCE 的包裝函式。
若要執行這項作業,請使用 IOCTL_CDROM_GET_PERFORMANCE 呼叫 DeviceIoControl 函式作為 dwIoControlCode 參數。
主要程序代碼
輸入緩衝區
CDROM_PERFORMANCE_REQUEST 要求效能數據。 CDROM_WRITE_SPEED_REQUEST 要求寫入速度描述元。
輸入緩衝區長度
輸出緩衝區
針對要求類型 CdromWriteSpeedRequest,此 IOCTL 會傳回 CDROM_PERFORMANCE_HEADER 結構,後面接著一些CDROM_WRITE_SPEED_DESCRIPTOR描述元。
針對要求類型 CdromPerformanceRequest,此 IOCTL 會傳回 CDROM_PERFORMANCE_HEADER 結構,後面接著選擇性描述元。 此標頭後面的描述項取決於 CDROM_PERFORMANCE_HEADER 結構 字段 中的值。 如果 為 false,則會使用 CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR;否則會使用CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR。
輸出緩衝區長度
狀態區塊
[資訊] 字段會設定為傳回的位元元組數。
由於來自其他 API 的狀態代碼傳播,狀態 欄位可以設定為 (但不限於) 下列專案:
STATUS_BUFFER_TOO_SMALL
輸出緩衝區長度小於必要。
STATUS_INFO_LENGTH_MISMATCH
輸入緩衝區長度小於必要。
STATUS_INVALID_DEVICE_REQUEST
裝置不支援此要求。
STATUS_INVALID_PARAMETER
CDROM_PERFORMANCE_REQUEST標頭不包含列舉所指定之參數的有效組合。
STATUS_SUCCESS
要求成功完成。
要求
要求 | 價值 |
---|---|
標頭 | ntddcdrm.h (包括 Winioctl.h) |