Compartilhar via


Método IDiscMaster::SetActiveDiscRecorder (imapi.h)

Seleciona um gravador de disco ativo. O gravador de disco ativo é o gravador em que ocorrerá uma gravação quando RecordDisc for chamado.

Sintaxe

HRESULT SetActiveDiscRecorder(
  [in] IDiscRecorder *pRecorder
);

Parâmetros

[in] pRecorder

Ponteiro para a interface IDiscRecorder de um objeto gravador de disco. Esse ponteiro deveria ter sido retornado por uma chamada anterior para EnumDiscRecorders.

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:

Comentários

SetActiveDiscRecorder deve ser chamado depois que a mídia a ser usada tiver sido inserida e antes de chamar IJolietDiscMaster::AddData.

Selecionar um gravador enquanto estiver em um formato Joliet ativo fará com que o IMAPI leia informações do disco gravador instalado no momento. Se esse disco for um disco Joliet IMAPI anterior e tiver espaço para outra sessão, o IMAPI se definirá automaticamente para o modo de várias sessões. Esse disco deve estar no gravador ativo quando RecordDisc for chamado.

A propriedade MaxWriteSpeed é atualizada quando esse método é chamado. A configuração padrão é a velocidade de gravação mais alta.

Requisitos

   
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

Confira também

IDiscMaster