estrutura CDROM_SET_STREAMING (ntddcdrm.h)

A estrutura CDROM_SET_SPEED é usada com a solicitação IOCTL_CDROM_SET_SPEED para definir a velocidade do eixo de uma unidade cd-ROM durante transferências isócronas que permitem alguma perda de dados.

Sintaxe

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;

Membros

RequestType

Um valor de tipo CDROM_SPEED_REQUEST que indica qual comando multimídia usar ao definir a velocidade do eixo.

ReadSize

O número de quilobytes a serem lidos em cada unidade de tempo, em que uma unidade de tempo é especificada por ReadTime. Um valor de 0xFFFF em ReadSize seleciona a velocidade de transferência de dados ideal da unidade.

ReadTime

O número de milissegundos nos quais ler ReadSize quilobytes de dados.

WriteSize

O número de quilobytes a serem gravados em cada unidade de tempo, em que uma unidade de tempo é definida por WriteTime. Um valor de 0xFFFF em WriteSize seleciona a velocidade de transferência de dados ideal da unidade.

WriteTime

O número de milissegundos nos quais gravar WriteSize quilobytes de dados.

StartLba

O primeiro endereço de bloco lógico, em bytes, da solicitação IOCTL_CDROM_SET_SPEED.

EndLba

O último endereço de bloco lógico, em bytes, da solicitação IOCTL_CDROM_SET_SPEED.

RotationControl

Um valor de tipo WRITE_ROTATION que indica se o dispositivo gravará na mídia usando rotação CLV (velocidade linear constante) ou rotação cla (velocidade angular constante).

RestoreDefaults

Um valor BOOLEAN que, quando TRUE, instrui o driver de classe CD-ROM a fazer com que a unidade CD-ROM seja executada em sua velocidade de eixo padrão. Um valor false instrui o driver de classe a calcular a velocidade do eixo dos membros ReadSize, ReadTime, WriteSize e WriteTime dessa estrutura.

SetExact

Um valor BOOLEAN que, quando TRUE, instrui o driver de classe CD-ROM a definir a unidade CD-ROM com a velocidade exata especificada pelos membros ReadSize, ReadTime, WriteSize e WriteTime dessa estrutura. Se o driver de classe não puder definir a velocidade do eixo para o valor exato especificado por esses membros, ele falhará na solicitação. Um valor false emSetExact instrui o driver de classe a fazer com que a velocidade do eixo da unidade corresponda o mais próximo possível da velocidade especificada por ReadSize, ReadTime, WriteSize e WriteTime; o driver de classe não falhará na solicitação se a unidade não puder ser executada com o valor exato especificado por esses membros.

RandomAccess

Um valor BOOLEAN que, quando TRUE, instrui o driver de classe CD-ROM a configurar a unidade CD-ROM, para que ela alterne entre operações de leitura e gravação para maximizar o desempenho (taxa de transferência de dados), mesmo que alternar entre operações de leitura e gravação faça com que uma operação de leitura ou gravação específica ocorra mais lentamente. Em outras palavras, um valor true emRandomAccess permite que a unidade reduza a velocidade de algumas operações individuais de leitura e gravação para garantir um melhor desempenho geral nas transferências de dados. Um valor false instrui o driver de classe CD-ROM a configurar a unidade CD-ROM para garantir as velocidades das operações de leitura e gravação, independentemente umas das outras. A taxa de transferência de dados de cada operação é rígida e a unidade não alterará a velocidade para obter ganhos de desempenho.

Persistent

Um valor BOOLEAN que, quando TRUE, instrui o driver de classe CD-ROM a configurar a unidade CD-ROM para restaurar a velocidade padrão quando o usuário altera a mídia. Um valor false instrui o driver de classe CD-ROM a configurar a unidade CD-ROM para manter sua velocidade até que o computador seja reiniciado ou o driver de classe altere a velocidade com outro comando.

Requisitos

Requisito	Valor
Cabeçalho	ntddcdrm.h (inclua Ntddcdrm.h)

Confira também

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION