CDROM_SET_STREAMING-Struktur (ntddcdrm.h)

Die CDROM_SET_SPEED-Struktur wird mit der IOCTL_CDROM_SET_SPEED-Anforderung verwendet, um die Spindelgeschwindigkeit eines CD-ROM-Laufwerks bei isochronen Übertragungen festzulegen, die einen Datenverlust ermöglichen.

Syntax

typedef struct _CDROM_SET_STREAMING {
  CDROM_SPEED_REQUEST RequestType;
  ULONG               ReadSize;
  ULONG               ReadTime;
  ULONG               WriteSize;
  ULONG               WriteTime;
  ULONG               StartLba;
  ULONG               EndLba;
  WRITE_ROTATION      RotationControl;
  BOOLEAN             RestoreDefaults;
  BOOLEAN             SetExact;
  BOOLEAN             RandomAccess;
  BOOLEAN             Persistent;
} CDROM_SET_STREAMING, *PCDROM_SET_STREAMING;

Member

RequestType

Ein CDROM_SPEED_REQUEST typisierter Wert, der angibt, welcher Multimediabefehl beim Festlegen der Spindeldrehzahl verwendet werden soll.

ReadSize

Die Anzahl der zu lesenden Kilobytes in jeder Zeiteinheit, wobei eine Zeiteinheit durch ReadTime angegeben wird. Der Wert 0xFFFF in ReadSize wählt die optimale Datenübertragungsgeschwindigkeit des Laufwerks aus.

ReadTime

Die Anzahl der Millisekunden, in denen ReadSize-Kilobytes an Daten gelesen werden sollen.

WriteSize

Die Anzahl der zu schreibenden Kilobytes in jeder Zeiteinheit, wobei eine Zeiteinheit durch WriteTime definiert wird. Der Wert 0xFFFF in WriteSize wählt die optimale Datenübertragungsgeschwindigkeit des Laufwerks aus.

WriteTime

Die Anzahl der Millisekunden, in denen WriteSize-Kilobytes an Daten geschrieben werden sollen.

StartLba

Die erste logische Blockadresse (in Bytes) der IOCTL_CDROM_SET_SPEED Anforderung.

EndLba

Die letzte logische Blockadresse (in Bytes) der IOCTL_CDROM_SET_SPEED Anforderung.

RotationControl

Ein WRITE_ROTATION typisierter Wert, der angibt, ob das Gerät mithilfe der CLV-Drehung (konstante lineare Geschwindigkeit) oder der CLA -Drehung (konstante Winkelgeschwindigkeit) auf das Medium schreibt.

RestoreDefaults

Ein BOOLEAN-Wert, der bei TRUE den CD-ROM-Klassentreiber anweist, das CD-ROM-Laufwerk mit seiner Standardspindelgeschwindigkeit auszuführen. Der Wert FALSE weist den Klassentreiber an, die Spindelgeschwindigkeit aus den Membern ReadSize, ReadTime, WriteSize und WriteTime dieser Struktur zu berechnen.

SetExact

Ein BOOLEAN-Wert, der bei TRUE den CD-ROM-Klassentreiber anweist, das CD-ROM-Laufwerk auf die genaue Geschwindigkeit festzulegen, die von den ReadSize-, ReadTime-, WriteSize- und WriteTime-Membern dieser Struktur angegeben wird. Wenn der Klassentreiber die Spindelgeschwindigkeit nicht auf den genauen Wert festlegen kann, der von diesen Membern angegeben wird, schlägt die Anforderung fehl. Der Wert FALSE in SetExact weist den Klassentreiber an, die Spindeldrehzahl des Laufwerks so genau wie möglich mit der Geschwindigkeit zu übereinstimmen, die von ReadSize, ReadTime, WriteSize und WriteTime angegeben wird. Der Klassentreiber schlägt die Anforderung nicht fehl, wenn das Laufwerk nicht mit dem genauen Wert ausgeführt werden kann, den diese Member angeben.

RandomAccess

Ein BOOLEAN-Wert, der bei TRUE den CD-ROM-Klassentreiber anweist, das CD-ROM-Laufwerk zu konfigurieren, sodass es zwischen Lese- und Schreibvorgängen hin- und herwechselt, um die Leistung (Datendurchsatz) zu maximieren, auch wenn das Wechseln zwischen Lese- und Schreibvorgängen dazu führt, dass ein bestimmter Lese- oder Schreibvorgang langsamer erfolgt. Mit anderen Worten, der Wert TRUE in RandomAccess ermöglicht es dem Laufwerk, die Geschwindigkeit einiger einzelner Lese- und Schreibvorgänge zu verringern, um eine bessere Gesamtleistung bei Datenübertragungen zu gewährleisten. Der Wert FALSE weist den CD-ROM-Klassentreiber an, das CD-ROM-Laufwerk zu konfigurieren, um die Geschwindigkeit von Lese- und Schreibvorgängen unabhängig voneinander zu gewährleisten. Die Datenübertragungsrate jedes Vorgangs ist starr, und das Laufwerk ändert die Geschwindigkeit nicht, um Leistungssteigerungen zu erzielen.

Persistent

Ein BOOLEAN-Wert, der bei TRUE den CD-ROM-Klassentreiber anweist, das CD-ROM-Laufwerk so zu konfigurieren, dass die Standardgeschwindigkeit wiederhergestellt wird, wenn der Benutzer das Medium ändert. Der Wert FALSE weist den CD-ROM-Klassentreiber an, das CD-ROM-Laufwerk so zu konfigurieren, dass seine Geschwindigkeit beibehalten wird, bis der Computer neu gestartet wird oder der Klassentreiber die Geschwindigkeit mit einem anderen Befehl ändert.

Anforderungen

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

Weitere Informationen

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION