Método IDiscFormat2TrackAtOnce::SetWriteSpeed (imapi2.h)
Define a velocidade de gravação do gravador de disco.
Sintaxe
HRESULT SetWriteSpeed(
[in] LONG RequestedSectorsPerSecond,
[in] VARIANT_BOOL RotationTypeIsPureCAV
);
Parâmetros
[in] RequestedSectorsPerSecond
Velocidade de gravação solicitada medida em setores de disco por segundo.
Um valor de 0xFFFFFFFF (-1) solicitações que a gravação ocorre usando a velocidade mais rápida com suporte para a mídia. Esse é o padrão.
[in] RotationTypeIsPureCAV
Tipo de controle de velocidade rotacional solicitado. Defina como VARIANT_TRUE para solicitar o tipo de controle de velocidade rotacional CAV (velocidade angular constante). Defina como VARIANT_FALSE para usar outro tipo de controle de velocidade rotacional compatível com o gravador. O padrão é VARIANT_FALSE.
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
| Código de retorno | Descrição |
|---|---|
|
A solicitação requer que um gravador de disco atual seja selecionado.
Valor: 0xC0AA0003 |
|
Um ou mais argumentos não são válidos.
Valor: 0x80070057 |
|
O ponteiro não é válido.
Valor: 0x80004003 |
|
Falha não especificada.
Valor: 0x80004005 |
|
Falha ao alocar a memória necessária.
Valor: 0x8007000E |
|
O dispositivo não aceitou o comando dentro do período de tempo limite. Isso pode ser causado pelo dispositivo ter inserido um estado inconsistente ou o valor de tempo limite para o comando pode precisar ser aumentado.
Valor: 0xC0AA020D |
|
O dispositivo relatou dados inesperados ou inválidos para um comando.
Valor: 0xC0AA02FF |
|
A mídia é inserida de cabeça para baixo.
Valor: 0xC0AA0204 |
|
A unidade informou que está em processo de preparação. Tente a solicitação novamente mais tarde.
Valor: 0xC0AA0205 |
|
Não há mídia no dispositivo.
Valor: 0xC0AA0202 |
|
A mídia está sendo formatada no momento. Aguarde a conclusão do formato antes de tentar usar a mídia.
Valor: 0xC0AA0206 |
|
A unidade informou que está executando uma operação de longa execução, como terminar uma gravação. A unidade pode ser inutilizável por um longo período de tempo.
Valor: 0xC0AA0207 |
|
A gravação falhou porque a unidade não recebeu dados rapidamente o suficiente para continuar gravando. Mover os dados de origem para o computador local, reduzir a velocidade de gravação ou habilitar uma configuração de "buffer sem execução livre" pode resolve esse problema.
Valor: 0xC0AA0300 |
|
A mídia não é compatível ou de formato físico desconhecido.
Valor: 0xC0AA0203 |
|
A estrutura do DVD não está presente. Isso pode ser causado por uma unidade/meio incompatível usada.
Valor: 0xC0AA020E |
|
O dispositivo informou que a página do modo solicitado (e o tipo) não está presente.
Valor: 0xC0AA0201 |
|
A unidade informou que não havia suporte para a combinação de parâmetros fornecidos na página de modo para um comando MODE SELECT.
Valor: 0xC0AA0208 |
|
A unidade informou que a mídia está protegida por gravação.
Valor: 0xC0AA0209 |
|
A velocidade da mídia é incompatível com o dispositivo. Isso pode ser causado pelo uso de mídia de velocidade maior ou menor do que o intervalo de velocidades com suporte do dispositivo.
Valor: 0xC0AA020F |
|
O identificador especificado é inválido.
Valor: 6 |
|
O recurso de rede ou dispositivo especificado não está mais disponível.
Valor: 55 |
|
O dispositivo associado a esse gravador durante a última operação foi bloqueado exclusivamente, fazendo com que essa operação falhasse.
Valor: 0xC0AA0210 |
|
A gravação falhou porque a unidade retornou informações de erro das quais não foi possível recuperar.
Valor: 0xC0AA0301 |
|
Não havia suporte para o tipo de rotação solicitado pela unidade e o tipo de rotação foi ajustado.
Valor: 0x00AA0005 |
|
Não havia suporte para a velocidade de gravação solicitada pela unidade e a velocidade foi ajustada.
Valor: 0x00AA0004 |
|
A velocidade de gravação solicitada e o tipo de rotação não eram compatíveis com a unidade e ambos foram ajustados.
Valor: 0x00AA0006 |
Comentários
Esse método define a velocidade de gravação e o tipo de controle de velocidade rotacional para um gravador. Os valores solicitados podem ser diferentes dos valores definidos no gravador. Para especificar o gravador, chame o método IDiscFormat2TrackAtOnce::p ut_Recorder .
Se o gravador der suporte à velocidade de gravação solicitada, o dispositivo de disco usará o valor solicitado. Se o gravador não der suporte à velocidade de gravação solicitada, o gravador usará uma velocidade de gravação à qual ele dá suporte mais próximo ao valor solicitado. A propriedade IDiscFormat2TrackAtOnce::get_CurrentWriteSpeed contém o valor usado pelo gravador.
Para recuperar uma lista das velocidades de gravação compatíveis com o gravador e a mídia atual, chame o método IDiscFormat2TrackAtOnce::get_SupportedWriteSpeeds .
Se você solicitar cav (velocidade angular constante) para o tipo de controle de velocidade rotacional e o gravador não der suporte a CAV, o dispositivo de disco usará outro tipo de controle de velocidade rotacional compatível. A propriedade IDiscFormat2TrackAtOnce::get_CurrentRotationTypeIsPureCAV indica o valor usado pelo gravador.
Para recuperar os valores solicitados, chame os métodos IDiscFormat2TrackAtOnce::get_RequestedWriteSpeed e IDiscFormat2TrackAtOnce::get_RequestedRotationTypeIsPureCAV .
Requisitos
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2.h |
Confira também
IDiscFormat2TrackAtOnce::get_CurrentRotationTypeIsPureCAV
IDiscFormat2TrackAtOnce::get_RequestedRotationTypeIsPureCAV