共用方式為


IOCTL_CDROM_GET_PERFORMANCE IOCTL (ntddcdrm.h)

從裝置擷取支援的速度。 IOCTL_CDROM_GET_PERFORMANCE I/O 控制件要求是 MMC 命令 GET PERFORMANCE 的包裝函式。

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

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

CDROM_PERFORMANCE_REQUEST 要求效能數據。 CDROM_WRITE_SPEED_REQUEST 要求寫入速度描述元。

輸入緩衝區長度

CDROM_PERFORMANCE_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。

輸出緩衝區長度

CDROM_PERFORMANCE_HEADER的長度。

狀態區塊

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

由於來自其他 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)

另請參閱

CDROM_PERFORMANCE_HEADER

CDROM_PERFORMANCE_REQUEST

CDROM_WRITE_SPEED_REQUEST

DeviceIoControl