Compartilhar via

Método IDiscRecorder2::EnableMcn (imapi2.h)

  • Artigo

Habilita a MCN (Notificação de Alteração de Mídia) para o dispositivo.

Sintaxe

HRESULT EnableMcn();

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:

Código de retorno Descrição
E_FAIL
 Falha não especificada.

Valor: 0x80004005
E_OUTOFMEMORY
 Falha ao alocar a memória necessária.

Valor: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT
 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
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
 O identificador especificado é inválido.

Valor: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
 O recurso de rede ou dispositivo especificado não está mais disponível.

Valor: 55
E_IMAPI_RECORDER_LOCKED
 O dispositivo associado a esse gravador durante a última operação foi bloqueado exclusivamente, fazendo com que essa operação falhasse.

Valor: 0xC0AA0210

Comentários

MCN é o método do driver de dispositivo CD-ROM de detectar alterações de mídia e alterações de estado no dispositivo CD-ROM. Por exemplo, quando você altera a mídia em um dispositivo CD-ROM, uma mensagem MCN é enviada para disparar recursos de mídia, como reprodução automática. O MCN está habilitado por padrão. Chame esse método para habilitar notificações quando as notificações tiverem sido desabilitadas usando IDiscRecorder2::D isableMcn.

Observe que DisableMcn incrementa uma contagem de referência sempre que é chamada. O método EnableMcn diminui a contagem. O dispositivo é habilitado quando a contagem de referência é zero.

Requisitos

Requisito Valor
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

IDiscRecorder2

IDiscRecorder2::D isableMcn