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.
| Evento | Descrição |
|---|---|
| ADVISE_NONE | Sem alterações. |
| ADVISE_CLIPPING | Alteração na região de recorte (sincronizada com a janela). |
| ADVISE_PALETTE | Alterar na paleta. |
| ADVISE_COLORKEY | Alteração do valor da chave chroma. |
| ADVISE_POSITION | Alteração na posição da janela de vídeo (não sincronizada com a janela). |
| ADVISE_DISPLAY_CHANGE | Chamado no WM_DISPLAYCHANGE. A mensagem WM_DISPLAYCHANGE é enviada para todas as janelas quando a resolução de exibição é alterada. |
| ADVISE_ALL2 | Todas as opções acima. |
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
| 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 |