Compartilhar via

Método IDDrawExclModeVideo::SetCallbackInterface (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetCallbackInterface método recupera um ponteiro para a interface de retorno de chamada do Overlay Mixer para que o aplicativo de chamada possa ser notificado sobre ajustes na exibição durante a reprodução de vídeo.

Sintaxe

HRESULT SetCallbackInterface(
  [out] IDDrawExclModeVideoCallback *pCallback,
  [in]  DWORD                       dwFlags
);

Parâmetros

[out] pCallback

Ponteiro para o objeto que implementa a interface IDDrawExclModeVideoCallback . Se pCallback for NULL, a interface de retorno de chamada será definida como NULL e não serão feitos mais retornos de chamada. Se houver uma interface de retorno de chamada anterior, ela será liberada e não serão feitos mais retornos de chamada para ela. Se pCallback não for NULL e esse método retornar S_OK, a contagem de referência do objeto para o qual pCallback aponta será incrementada.

[in] dwFlags

Deve ser zero.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 O argumento é inválido.

Comentários

Um aplicativo deve usar esse método para receber notificação sobre o tamanho da sobreposição, a posição ou a alteração da chave de cor acontecendo, para que ele possa ocultar ou mostrar o vídeo ou ajustar o vídeo no início, no final ou durante a reprodução. Chamando esse método, um aplicativo pode acessar a interface IDDrawExclModeVideoCallback e passar o ponteiro para essa interface para o Mixer de Sobreposição.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IDDrawExclModeVideo Interface