Método IOverlay::Advise (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 Advise método configura um link de consultoria para os eventos de sobreposição especificados pelo parâmetro dwInterests .

Sintaxe

HRESULT Advise(
  [in] IOverlayNotify *pOverlayNotify,
  [in] DWORD          dwInterests
);

Parâmetros

[in] pOverlayNotify

Ponteiro para a interface de notificação.

[in] dwInterests

Retornos de chamada de interesse, que podem ser qualquer subconjunto dos eventos a seguir.

Retornar valor

Retorna S_OK se tiver êxito. Se o método falhar, ele retornará um código de erro HRESULT .

Comentários

Esse método configura um link de consultoria para que a interface IOverlayNotify receba notificações. Se um desses eventos ocorrer, o ponto de entrada apropriado no parâmetro pOverlayNotify passado será chamado (IOverlayNotify::OnClipChange, IOverlayNotify::OnColorKeyChange, IOverlayNotify::OnPaletteChange ou IOverlayNotify::OnPositionChange).

Somente um link de consultoria pode ser definido em qualquer interface IOverlay fornecida. Tentar definir outra interface de notificação na segunda e chamadas subsequentes retorna VFW_E_ADVISE_ALREADY_SET. Você pode cancelar um link de consultoria usando IOverlay::Unadvise.

Requisitos

Confira também

Códigos de erro e êxito

IOverlay Interface