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 |