estructura CDROM_SET_STREAMING (ntddcdrm.h)

La estructura CDROM_SET_SPEED se usa con la solicitud de IOCTL_CDROM_SET_SPEED para establecer la velocidad del husillo de una unidad de CD-ROM durante las transferencias isócrónicas que permiten la pérdida de datos.

Sintaxis

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;

Miembros

RequestType

Valor con tipo CDROM_SPEED_REQUEST que indica qué comando multimedia se va a usar al establecer la velocidad del husillo.

ReadSize

Número de kilobytes que se van a leer en cada unidad de tiempo, donde readTime especifica una unidad de tiempo. Un valor de 0xFFFF en ReadSize selecciona la velocidad óptima de transferencia de datos de la unidad.

ReadTime

Número de milisegundos en los que se va a leer ReadSize kilobytes de datos.

WriteSize

Número de kilobytes que se van a escribir en cada unidad de tiempo, donde una unidad de tiempo se define mediante WriteTime. Un valor de 0xFFFF en WriteSize selecciona la velocidad óptima de transferencia de datos de la unidad.

WriteTime

Número de milisegundos en los que se va a escribir WriteSize kilobytes de datos.

StartLba

La primera dirección de bloque lógico, en bytes, de la solicitud de IOCTL_CDROM_SET_SPEED.

EndLba

La última dirección de bloque lógico, en bytes, de la solicitud de IOCTL_CDROM_SET_SPEED.

RotationControl

Valor de tipo WRITE_ROTATION que indica si el dispositivo escribirá en el medio mediante la rotación de CLV (velocidad lineal constante) o la rotación de CLA (velocidad angular constante).

RestoreDefaults

Valor BOOLEAN que, cuando es TRUE, indica al controlador de clase CD-ROM que haga que la unidad de CD-ROM se ejecute a su velocidad de husillo predeterminada. Un valor de FALSE indica al controlador de clase que calcule la velocidad del husillo a partir de los miembros ReadSize, ReadTime, WriteSize y WriteTime de esta estructura.

SetExact

Valor BOOLEAN que, cuando es TRUE, indica al controlador de clase CD-ROM que establezca la unidad de CD-ROM en la velocidad exacta especificada por los miembros ReadSize, ReadTime, WriteSize y WriteTime de esta estructura. Si el controlador de clase no puede establecer la velocidad del husillo en el valor exacto especificado por estos miembros, se produce un error en la solicitud. Un valor false en SetExact indica al controlador de clase que haga que la velocidad del eje de la unidad coincida lo más cerca posible de la velocidad especificada por ReadSize, ReadTime, WriteSize y WriteTime; el controlador de clase no produce un error en la solicitud si la unidad no se puede ejecutar en el valor exacto que especifican estos miembros.

RandomAccess

Valor BOOLEAN que, cuando es TRUE, indica al controlador de clase CD-ROM que configure la unidad cd-ROM, de modo que cambie entre las operaciones de lectura y escritura para maximizar el rendimiento (rendimiento de los datos), incluso si el cambio entre las operaciones de lectura y escritura hace que se produzca una operación de lectura o escritura determinada más lentamente. En otras palabras, un valor true enRandomAccess permite que la unidad reduzca la velocidad de algunas operaciones individuales de lectura y escritura para garantizar un mejor rendimiento general en las transferencias de datos. Un valor false indica al controlador de clase CD-ROM que configure la unidad CD-ROM para garantizar las velocidades de las operaciones de lectura y escritura, independientemente entre sí. La velocidad de transferencia de datos de cada operación es rígida y la unidad no modificará la velocidad para lograr mejoras de rendimiento.

Persistent

Valor BOOLEAN que, cuando es TRUE, indica al controlador de clase CD-ROM que configure la unidad de CD-ROM para restaurar la velocidad predeterminada cuando el usuario cambia el medio. Un valor false indica al controlador de clase CD-ROM que configure la unidad CD-ROM para mantener su velocidad hasta que el equipo se reinicie o el controlador de clase cambie la velocidad con otro comando.

Requisitos

Requisito	Valor
Header	ntddcdrm.h (incluya Ntddcdrm.h)

Consulte también

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION