IOCTL_CDROM_GET_PERFORMANCE IOCTL (ntddcdrm.h)
從裝置擷取支援的速度。 IOCTL_CDROM_GET_PERFORMANCE I/O 控制要求是 MMC 命令 GET PERFORMANCE 的包裝函式。
若要執行這項作業，請使用 IOCTL_CDROM_GET_PERFORMANCE 作為 dwIoControlCode 參數呼叫 DeviceIoControl 函式。
主要程序代碼
輸入緩衝區
CDROM_PERFORMANCE_REQUEST 要求效能數據。 CDROM_WRITE_SPEED_REQUEST 要求寫入速度描述元。
輸入緩衝區長度
輸出緩衝區
針對要求類型 CdromWriteSpeedRequest，此 IOCTL 會傳回 CDROM_PERFORMANCE_HEADER 結構，後面接著數個CDROM_WRITE_SPEED_DESCRIPTOR描述元。
針對要求類型 CdromPerformanceRequest，此 IOCTL 會傳回 CDROM_PERFORMANCE_HEADER 結構，後面接著選擇性描述元。 此標頭後面的描述項取決於CDROM_PERFORMANCE_HEADER 結構的 [例外] 字段中的值。 如果 Except 為 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) |