struttura CDROM_SET_STREAMING (ntddcdrm.h)

La struttura CDROM_SET_SPEED viene usata con la richiesta di IOCTL_CDROM_SET_SPEED per impostare la velocità di rotazione di un'unità CD-ROM durante trasferimenti isocroni che consentono una perdita di dati.

Sintassi

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;

Members

RequestType

Valore CDROM_SPEED_REQUEST tipizzato che indica quale comando multimediale utilizzare quando si imposta la velocità di rotazione.

ReadSize

Numero di kilobyte da leggere in ogni unità di tempo, in cui un'unità di tempo viene specificata da ReadTime. Un valore di 0xFFFF in ReadSize seleziona la velocità di trasferimento dati ottimale dell'unità.

ReadTime

Numero di millisecondi in cui leggere i kilobyte readSize dei dati.

WriteSize

Numero di kilobyte da scrivere in ogni unità di tempo, in cui un'unità di tempo è definita da WriteTime. Un valore di 0xFFFF in WriteSize seleziona la velocità di trasferimento dei dati ottimale dell'unità.

WriteTime

Numero di millisecondi in cui scrivere i kilobyte writeSize dei dati.

StartLba

Primo indirizzo del blocco logico, in byte, della richiesta di IOCTL_CDROM_SET_SPEED.

EndLba

Ultimo indirizzo del blocco logico, in byte, della richiesta di IOCTL_CDROM_SET_SPEED.

RotationControl

Valore WRITE_ROTATION tipizzato che indica se il dispositivo scriverà nel supporto usando la rotazione CLV (velocità lineare costante) o la rotazione CLA (velocità angolare costante).

RestoreDefaults

Valore BOOLEAN che, quando TRUE, indica al driver di classe CD-ROM di eseguire l'unità CD-ROM alla velocità di rotazione predefinita. Un valore FALSE indica al driver di classe di calcolare la velocità di rotazione dai membri ReadSize, ReadTime, WriteSize e WriteTime di questa struttura.

SetExact

Valore BOOLEAN che, se TRUE, indica al driver di classe CD-ROM di impostare l'unità CD-ROM sulla velocità esatta specificata dai membri ReadSize, ReadTime, WriteSize e WriteTime di questa struttura. Se il driver di classe non può impostare la velocità di rotazione sul valore esatto specificato da questi membri, la richiesta non riesce. Un valore FALSE in SetExact indica al driver di classe di rendere la velocità di rotazione dell'unità il più possibile la velocità specificata da ReadSize, ReadTime, WriteSize e WriteTime; Il driver di classe non riesce la richiesta se l'unità non può essere eseguita con il valore esatto specificato da questi membri.

RandomAccess

Valore BOOLEAN che, se TRUE, indica al driver di classe CD-ROM di configurare l'unità CD-ROM, in modo che cambierà tra operazioni di lettura e scrittura per ottimizzare le prestazioni (velocità effettiva dei dati), anche se il passaggio tra operazioni di lettura e scrittura causa un'operazione di lettura o scrittura particolare si verificherà più lentamente. In altre parole, un valore true in RandomAccess consente all'unità di ridurre la velocità di alcune singole operazioni di lettura e scrittura per garantire prestazioni complessive migliori nei trasferimenti di dati. Il valore FALSE indica al driver di classe CD-ROM di configurare l'unità CD-ROM per garantire la velocità delle operazioni di lettura e scrittura, indipendentemente l'una dall'altra. La velocità di trasferimento dei dati di ogni operazione è rigida e l'unità non modificherà la velocità per ottenere miglioramenti delle prestazioni.

Persistent

Valore BOOLEAN che, se TRUE, indica al driver di classe CD-ROM di configurare l'unità CD-ROM per ripristinare la velocità predefinita quando l'utente modifica il supporto. Un valore FALSE indica al driver di classe CD-ROM di configurare l'unità CD-ROM per mantenere la velocità fino al riavvio del computer o il driver di classe cambia la velocità con un altro comando.

Requisiti

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

Vedi anche

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION