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 de tipo CDROM_SPEED_REQUESTque 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 se especifica una unidad de tiempo mediante ReadTime. 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 se define una unidad de tiempo 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 IOCTL_CDROM_SET_SPEED.

EndLba

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

RotationControl

Valor de tipo WRITE_ROTATIONque 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 TRUE, indica al controlador de clase CD-ROM que la unidad de CD-ROM se ejecute en su velocidad de eje predeterminada. Un valor de FALSE indica al controlador de clase que calcule la velocidad del eje de ReadSize, ReadTime, WriteSizey miembros de esta estructura.

SetExact

Valor BOOLEAN que, cuando TRUE, indica al controlador de clase CD-ROM que establezca la unidad de CD-ROM en la velocidad exacta especificada por el ReadSize, ReadTime, WriteSizey miembros 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 de FALSE en SetExact indica al controlador de clase que haga que la velocidad del husillo de la unidad coincida lo más cerca posible de la velocidad especificada por ReadSize, ReadTime, WriteSizey WriteTime; El controlador de clase no produce un error en la solicitud si la unidad no se puede ejecutar con el valor exacto que especifican estos miembros.

RandomAccess

Valor BOOLEAN que, cuando TRUE, indica al controlador de clase CD-ROM que configure la unidad de CD-ROM, de modo que cambie entre las operaciones de lectura y escritura para maximizar el rendimiento (rendimiento de datos), incluso si el cambio entre operaciones de lectura y escritura hace que se produzca una operación de lectura o escritura determinada más lentamente. Es decir, un valor de TRUE en RandomAccess 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 de FALSE indica al controlador de clase CD-ROM que configure la unidad de 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 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 de FALSE indica al controlador de clase CD-ROM que configure la unidad de CD-ROM para mantener su velocidad hasta que el equipo se reinicie o el controlador de clase cambie la velocidad con otro comando.

Requisitos

Consulte también

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION