Método IOverlayNotify::OnPositionChange (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 OnPositionChange método proporciona una notificación de que la posición ha cambiado.

Sintaxis

HRESULT OnPositionChange(
  [in] const RECT *pSourceRect,
  [in] const RECT *pDestinationRect
);

Parámetros

[in] pSourceRect

Puntero al rectángulo de vídeo de origen.

[in] pDestinationRect

Puntero al rectángulo de vídeo de destino. Tenga en cuenta que esto no se recorta en el área de visualización visible.

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 es una devolución de llamada diseñada para su uso por tarjetas de superposición de hardware que no desean el gasto de las actualizaciones de recorte sincrónicas y solo quieren saber cuándo cambian las posiciones de vídeo de origen o de destino.

A diferencia del método IOverlayNotify::OnClipChange , este método no se llama en sincronización con el cambio de ventana, sino en algún momento después de que la ventana haya cambiado (básicamente en el tiempo con WM_SIZE mensajes recibidos). Por lo tanto, esto es adecuado para las tarjetas de superposición que no superponen sus datos al búfer de fotogramas.

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 (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IOverlayNotify (interfaz)