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) |