Partilhar via


CDROM_SET_STREAMING estrutura (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 de CD-ROM durante transferências isocronas 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 CDROM_SPEED_REQUESTdigitado 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 no 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 no 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 digitado WRITE_ROTATIONque indica se o dispositivo gravará na mídia usando rotação CLV (velocidade linear constante) ou ROTAÇÃO DE CLA (velocidade angular constante).

RestoreDefaults

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

SetExact

Um valor BOOLEAN que, quando TRUE, instrui o driver de classe CD-ROM a definir a unidade CD-ROM à velocidade exata especificada pelos ReadSize, ReadTime, WriteSizee writetime membros 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 de FALSE no SetExact instrui o driver de classe a fazer a velocidade do eixo da unidade corresponder o mais próximo possível da velocidade especificada por ReadSize, readTime, WriteSizee 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 verdadeiro, instrui o driver de classe CD-ROM a configurar a unidade CD-ROM, de modo que ela alternará 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 de verdadeiro em RandomAccess 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 de 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 de CD-ROM para restaurar a velocidade padrão quando o usuário alterar a mídia. Um valor de 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)

Consulte também

CDROM_SET_SPEED

CDROM_SPEED_REQUEST

IOCTL_CDROM_SET_SPEED

WRITE_ROTATION