Método IDiscMaster::RecordDisc (imapi.h)
Queima a imagem em etapas para mídia no gravador de disco ativo.
Sintaxe
HRESULT RecordDisc(
[in] boolean bSimulate,
[in] boolean bEjectAfterBurn
);
Parâmetros
[in] bSimulate
Indica se a mídia está queimada. Se esse parâmetro for TRUE, a mídia no gravador de disco ativo não será realmente queimada. Em vez disso, uma gravação simulada é executada. A simulação é um bom teste de um gravador de disco, pois a maioria das operações são executadas como em uma gravação real. Se esse parâmetro for FALSE, a mídia no gravador será realmente queimada.
[in] bEjectAfterBurn
Indica se a mídia deve ser ejetada após a queima. Se esse parâmetro for TRUE, a mídia será ejetada. Se esse parâmetro for FALSE, a mídia não será ejetada.
Retornar valor
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 normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
Esse método retorna quando a gravação é concluída, embora os retornos de chamada de progresso sejam feitos se registrados com o método ProgressAdvise . Quaisquer erros fazem com que esse método retorne, com pouca ou nenhuma ação corretiva por parte desse método.
Os dados de imagem preparados não são válidos após uma chamada para RecordDisc. Isso permite que o aplicativo execute uma gravação simulada ou real da mídia. Para segurança, o conteúdo do arquivo stash é limpo automaticamente após a conclusão bem-sucedida da primeira chamada para esse método. Um disco deve ser preparado novamente para queimá-lo novamente.
O método RecordDisc espera trabalhar com mídia em branco para áudio. Caso contrário, a mídia pode precisar ser apagada (por exemplo, mídia CD-RW em uma unidade CD-RW). Consulte IDiscRecorder::Erase.
O método SetActiveDiscRecorder determina se há um disco de várias sessões IMAPI na unidade ativa após a configuração. Nesse caso, o IMAPI entra automaticamente no modo de várias sessões. Se no modo de várias sessões e uma chamada for feita para RecordDisc, o mesmo disco que estabeleceu o modo de várias sessões deverá estar no gravador ativo ou um código de erro de IMAPI_E_WRONGDISC será retornado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [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 | imapi.h |
| Biblioteca | Uuid.lib |
| DLL | Actxprxy.dll |