structure CDROM_SET_STREAMING (ntddcdrm.h)
La structure CDROM_SET_SPEED est utilisée avec la demande de IOCTL_CDROM_SET_SPEED pour définir la vitesse de rotation d’un lecteur CD-ROM pendant les transferts isochrones qui permettent une perte de données.
Syntaxe
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;
Membres
RequestType
Valeur CDROM_SPEED_REQUEST-typée qui indique la commande multimédia à utiliser lors de la définition de la vitesse de rotation.
ReadSize
Nombre de kilo-octets à lire dans chaque unité de temps, où une unité de temps est spécifiée par ReadTime. Une valeur de 0xFFFF dans ReadSize sélectionne la vitesse de transfert de données optimale du lecteur.
ReadTime
Nombre de millisecondes dans lesquelles lire ReadSize kilo-octets de données.
WriteSize
Nombre de kilo-octets à écrire dans chaque unité de temps, où une unité de temps est définie par WriteTime. Une valeur de 0xFFFF dans WriteSize sélectionne la vitesse de transfert de données optimale du lecteur.
WriteTime
Nombre de millisecondes dans lesquelles écrire WriteSize kilo-octets de données.
StartLba
Première adresse de bloc logique, en octets, de la requête IOCTL_CDROM_SET_SPEED.
EndLba
Dernière adresse de bloc logique, en octets, de la requête IOCTL_CDROM_SET_SPEED.
RotationControl
Valeur WRITE_ROTATION-typée qui indique si l’appareil écrit sur le support à l’aide de la rotation CLV (vitesse linéaire constante) ou de la rotation CLA (vitesse angulaire constante).
RestoreDefaults
Valeur BOOLEAN qui, quand TRUE, indique au pilote de classe CD-ROM d’exécuter le lecteur CD-ROM à sa vitesse de rotation par défaut. Une valeur de FALSE indique au pilote de classe de calculer la vitesse de rotation à partir du ReadSize, ReadTime, WriteSizeet membres writeTime de cette structure.
SetExact
Valeur BOOLEAN qui, lorsque TRUE, indique au pilote de classe CD-ROM de définir le lecteur CD-ROM sur la vitesse exacte spécifiée par le ReadSize, ReadTime, WriteSizeet membres WriteTime de cette structure. Si le pilote de classe ne peut pas définir la vitesse de rotation sur la valeur exacte spécifiée par ces membres, la requête échoue. Une valeur de FALSE dans SetExact indique au pilote de classe de rendre la vitesse de rotation du lecteur aussi proche que possible de la vitesse spécifiée par ReadSize, ReadTime, WriteSizeet WriteTime; le pilote de classe n’échoue pas la requête si le lecteur ne peut pas s’exécuter à la valeur exacte spécifiée par ces membres.
RandomAccess
Valeur BOOLEAN qui, lorsque TRUE, indique au pilote de classe CD-ROM de configurer le lecteur CD-ROM, afin qu’il bascule entre les opérations de lecture et d’écriture pour optimiser les performances (débit des données), même si le basculement entre les opérations de lecture et d’écriture entraîne une opération de lecture ou d’écriture particulière plus lentement. En d’autres termes, une valeur de TRUE dans RandomAccess permet au lecteur de réduire la vitesse de certaines opérations de lecture et d’écriture individuelles pour garantir de meilleures performances globales dans les transferts de données. Une valeur de FALSE indique au pilote de classe CD-ROM de configurer le lecteur CD-ROM pour garantir les vitesses d’opérations de lecture et d’écriture, indépendamment les unes des autres. Le taux de transfert de données de chaque opération est rigide et le lecteur ne modifie pas la vitesse pour atteindre les gains de performances.
Persistent
Valeur BOOLEAN qui, lorsque TRUE, indique au pilote de classe CD-ROM de configurer le lecteur CD-ROM pour restaurer la vitesse par défaut lorsque l’utilisateur modifie le média. Une valeur de FALSE indique au pilote de classe CD-ROM de configurer le lecteur CD-ROM pour maintenir sa vitesse jusqu’à ce que l’ordinateur redémarre ou que le pilote de classe change la vitesse avec une autre commande.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddcdrm.h (include Ntddcdrm.h) |