IOCTL_CDROM_GET_PERFORMANCE IOCTL (ntddcdrm.h)

Ruft die unterstützten Geschwindigkeiten vom Gerät ab. Die IOCTL_CDROM_GET_PERFORMANCE E/A-Steuerelementanforderung ist ein Wrapper für den MMC-Befehl GET PERFORMANCE.

Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl-Funktion mit IOCTL_CDROM_GET_PERFORMANCE als dwIoControlCode-Parameter auf.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

CDROM_PERFORMANCE_REQUEST fordert Leistungsdaten an. CDROM_WRITE_SPEED_REQUEST Anforderungen zum Schreiben von Geschwindigkeitsdeskriptor.

Eingabepufferlänge

Länge eines CDROM_PERFORMANCE_REQUEST.

Ausgabepuffer

Für den Anforderungstyp CdromWriteSpeedRequest gibt diese IOCTL die CDROM_PERFORMANCE_HEADER-Struktur gefolgt von einer Reihe von CDROM_WRITE_SPEED_DESCRIPTOR Deskriptoren zurück.

Für den Anforderungstyp CdromPerformanceRequest gibt diese IOCTL die CDROM_PERFORMANCE_HEADER-Struktur gefolgt von einem optionalen Deskriptor zurück. Der Deskriptor, der diesem Header folgt, hängt vom Wert im Feld Except der CDROM_PERFORMANCE_HEADER-Struktur ab. Wenn Except false ist, wird CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR verwendet. andernfalls wird CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR verwendet.

Länge des Ausgabepuffers

Länge eines CDROM_PERFORMANCE_HEADER.

Statusblock

Das Feld Information ist auf die Anzahl der zurückgegebenen Bytes festgelegt.

Aufgrund status Codeweitergabe von anderen APIs kann das Feld Status auf Folgendes (ist jedoch nicht beschränkt auf) festgelegt werden:

STATUS_BUFFER_TOO_SMALL

Die Länge des Ausgabepuffers ist kleiner als erforderlich.

STATUS_INFO_LENGTH_MISMATCH

Die Eingabepufferlänge ist kleiner als erforderlich.

STATUS_INVALID_DEVICE_REQUEST

Diese Anforderung wird vom Gerät nicht unterstützt.

STATUS_INVALID_PARAMETER

Der CDROM_PERFORMANCE_REQUEST-Header enthält keine gültige Kombination von Parametern, die durch Enumerationen angegeben werden.

STATUS_SUCCESS

Die Anforderung wurde erfolgreich abgeschlossen.

Anforderungen

Anforderung	Wert
Header	ntddcdrm.h (include Winioctl.h)

Weitere Informationen

CDROM_PERFORMANCE_HEADER

CDROM_PERFORMANCE_REQUEST

CDROM_WRITE_SPEED_REQUEST

DeviceIoControl