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

Consulte también

Códigos de error y éxito

IOverlayNotify (interfaz)