Método IDiscMaster::GetActiveDiscRecorder (imapi.h)
Recupera um ponteiro de interface para o gravador de disco ativo. O gravador de disco ativo é o gravador em que ocorrerá uma gravação quando RecordDisc for chamado.
Sintaxe
HRESULT GetActiveDiscRecorder(
[out] IDiscRecorder **ppRecorder
);
Parâmetros
[out] ppRecorder
Ponteiro para a interface IDiscRecorder do gravador de disco selecionado no momento.
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 normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
Não há nenhum gravador de disco ativo padrão. Um aplicativo que usa esse método deve selecionar especificamente um formato de masterização ativo e um gravador de disco ativo antes de iniciar uma gravação.
Observação
O gravador de disco ativo pode ser invalidado removendo o dispositivo ou alterando o formato de mastering de disco ativo. Por exemplo, um dispositivo USB CD-R pode ser desconectado do computador enquanto o aplicativo ainda está em execução (o aplicativo é alertado para essa condição por uma chamada para IDiscMasterProgressEvents::NotifyPnPActivity). Em ambos os casos, você deve selecionar um novo gravador de disco ativo.
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 |