Método IOverlayNotify::OnClipChange (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 OnClipChange método proporciona una notificación de que la región visible de la ventana ha cambiado. Es esencial que cualquier hardware de superposición se actualice para reflejar el cambio en la región visible antes de volver de este método.
Sintaxis
HRESULT OnClipChange(
[in] const RECT *pSourceRect,
[in] const RECT *pDestinationRect,
[in] const RGNDATA *pRgnData
);
Parámetros
[in] pSourceRect
Puntero a la región del vídeo que se va a usar.
[in] pDestinationRect
Puntero al destino del vídeo.
[in] pRgnData
Puntero a la información de recorte.
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 .
Observaciones
Las llamadas a se producen OnClipChange en la sincronización con la ventana. Se llama con una lista de clips vacía para inmovilizar el vídeo antes de que se mueva la ventana y, a continuación, se llama de nuevo cuando la ventana se ha estabilizado con la nueva lista de clips.
Si el rectángulo de la ventana es ceros, la ventana es invisible. Como es el caso de los descodificadores AVI, el descodificador debe guardar la imagen si se basa en la imagen actual para descodificar la siguiente.
Requisitos
| 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 (incluye Dshow.h) |
| Library | Strmiids.lib |