Condividi tramite


IOCTL_CDROM_GET_PERFORMANCE IOCTL (ntddcdrm.h)

Recupera le velocità supportate dal dispositivo. La IOCTL_CDROM_GET_PERFORMANCE richiesta di controllo I/O è un wrapper sul comando MMC, GET PERFORMANCE.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con IOCTL_CDROM_GET_PERFORMANCE come parametro dwIoControlCode.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

CDROM_PERFORMANCE_REQUEST richiede dati sulle prestazioni. CDROM_WRITE_SPEED_REQUEST richieste di descrittore velocità di scrittura.

Lunghezza del buffer di input

Lunghezza di un CDROM_PERFORMANCE_REQUEST.

Buffer di output

Per il tipo di richiesta CdromWriteSpeedRequest, questo IOCTL restituisce la struttura CDROM_PERFORMANCE_HEADER seguita da un numero di descrittori CDROM_WRITE_SPEED_DESCRIPTOR.

Per il tipo di richiesta CdromPerformanceRequest, questo IOCTL restituisce la struttura CDROM_PERFORMANCE_HEADER seguita da un descrittore facoltativo. Il descrittore che segue questa intestazione dipende dal valore nel campo Except della struttura CDROM_PERFORMANCE_HEADER . Se Except è false, viene usato CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR; in caso contrario, viene usato CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR.

Lunghezza del buffer di output

Lunghezza di un CDROM_PERFORMANCE_HEADER.

Blocco dello stato

Il campo Informazioni è impostato sul numero di byte restituiti.

A causa della propagazione del codice di stato da altre API, il campo Stato può essere impostato su (ma non è limitato a) quanto segue:

STATUS_BUFFER_TOO_SMALL

La lunghezza del buffer di output è inferiore a quella necessaria.

STATUS_INFO_LENGTH_MISMATCH

La lunghezza del buffer di input è inferiore a quella necessaria.

STATUS_INVALID_DEVICE_REQUEST

Il dispositivo non supporta questa richiesta.

STATUS_INVALID_PARAMETER

L'intestazione CDROM_PERFORMANCE_REQUEST non contiene una combinazione valida di parametri specificati dalle enumerazioni.

STATUS_SUCCESS

La richiesta è stata completata correttamente.

Requisiti

Requisito Valore
Intestazione ntddcdrm.h (include Winioctl.h)

Vedi anche

CDROM_PERFORMANCE_HEADER

CDROM_PERFORMANCE_REQUEST

CDROM_WRITE_SPEED_REQUEST

Deviceiocontrol