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) |