CDROM_PERFORMANCE_HEADER-Struktur (ntddcdrm.h)

Artikel
02/26/2024

Die CDROM_PERFORMANCE_HEADER-Struktur wird vom IOCTL_CDROM_GET_PERFORMANCE IOCTL verwendet, um Daten zurückzugeben. Wenn der Anforderungstyp CdromPerformanceRequest ist, gibt die IOCTL diesen Header gefolgt von optionalen Deskriptoren zurück.

Syntax

typedef struct _CDROM_PERFORMANCE_HEADER {
  UCHAR DataLength[4];
  UCHAR Except : 1;
  UCHAR Write : 1;
  UCHAR Reserved1 : 6;
  UCHAR Reserved2[3];
  UCHAR Data[0];
} CDROM_PERFORMANCE_HEADER, *PCDROM_PERFORMANCE_HEADER;

Member

DataLength[4]

Die Größe der verfügbaren Daten (nicht nur die Größe der zurückgegebenen Daten). Die Größe enthält dieses Datalength-Feld nicht.

Except

Das Format der Deskriptoren, die auf den Header folgen, hängt vom Wert in diesem Feld ab. Bei false (0) folgt der CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR der CDROM_PERFORMANCE_HEADER in den zurückgegebenen Daten. Bei true (1) folgt der CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR der CDROM_PERFORMANCE_HEADER in den zurückgegebenen Daten.

Write

Gibt an, ob die Ergebnisdaten für die Lese- oder Schreibleistung bestimmt sind. Wenn false (0) angegeben ist, gibt dies an, dass die Ergebnisdaten für die Leseleistung dienen. Wenn true (1) angegeben ist, gibt dies an, dass die Ergebnisdaten für die Schreibleistung gelten.

Reserved1

Reserviert.

Reserved2[3]

Reserviert.

Data[0]

Enthält je nach Anforderungstyp eine Liste der folgenden Datensätze: CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR,
CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR,
CDROM_WRITE_SPEED_DESCRIPTOR.