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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El Advise método configura un vínculo de aviso para los eventos de superposición especificados por el parámetro dwInterests .

Sintaxis

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

Parámetros

[in] pOverlayNotify

Puntero a la interfaz de notificación.

[in] dwInterests

Devoluciones de llamada de interés, que pueden ser cualquier subconjunto de los siguientes eventos.

Evento	Descripción
ADVISE_NONE	Sin cambios.
ADVISE_CLIPPING	Cambie en la región de recorte (sincronizada con la ventana).
ADVISE_PALETTE	Cambiar en la paleta.
ADVISE_COLORKEY	Cambio del valor de clave cromática.
ADVISE_POSITION	Cambie en la posición de la ventana de vídeo (no sincronizada con la ventana).
ADVISE_DISPLAY_CHANGE	Se llama en WM_DISPLAYCHANGE. El mensaje WM_DISPLAYCHANGE se envía a todas las ventanas cuando la resolución de pantalla ha cambiado.
ADVISE_ALL2	Todas las anteriores.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. Si se produce un error en el método, devuelve un código de error HRESULT .

Comentarios

Este método configura un vínculo de aviso para que la interfaz IOverlayNotify reciba notificaciones. Si se produce uno de estos eventos, se llama al punto de entrada adecuado del parámetro pOverlayNotify pasado (IOverlayNotify::OnClipChange, IOverlayNotify::OnColorKeyChange, IOverlayNotify::OnPaletteChange o IOverlayNotify::OnPositionChange).

Solo se puede establecer un vínculo de aviso en cualquier interfaz IOverlay determinada. Al intentar establecer otra interfaz de notificación en segundas y posteriores llamadas, se devuelve VFW_E_ADVISE_ALREADY_SET. Puede cancelar un vínculo de aviso mediante IOverlay::Unadvise.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IOverlay (interfaz)