Método IVideoFrameStep::Step (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 Step método hace que el gráfico de filtro avance paso a paso por el número especificado de fotogramas.
Sintaxis
HRESULT Step(
DWORD dwFrames,
IUnknown *pStepObject
);
Parámetros
dwFrames
Especifica el número de fotogramas que se van a omitir. Si dwFrames es 1, el grafo avanza un fotograma. Si dwFrames es un número n mayor que 1, el gráfico omite n - 1 fotogramas y muestra el nºfotograma.
pStepObject
Puntero a una interfaz en el filtro que controlará la operación de ejecución paso a paso o NULL. Especifique NULL para realizar la ejecución paso a paso del marco mediante el filtro del representador en el gráfico. Si no es NULL, el objeto debe implementar la interfaz IKsPropertySet y admitir la propiedad AM_KSPROPSETID_FrameStep. (Para obtener más información, vea Frame Stepping Property Set). Si el gráfico incluye un filtro personalizado que implementa la ejecución paso a paso del marco, pStepObject puede especificar un puntero a ese filtro.
Valor devuelto
Devuelve un VALOR HRESULT. Estos son algunos de los valores posibles.
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
No se admite la ejecución paso a paso de fotogramas. |
|
El parámetro pStepObject no es válido. |
Comentarios
Una vez completada la operación de paso, este método envía una notificación de evento EC_STEP_COMPLETE al administrador de gráficos de filtros, que lo pasará al bucle de eventos de la aplicación y establecerá el gráfico de filtro en un estado en pausa.
El paso de fotogramas en tiempo real, lo que significa que si la película se está reproduciendo en 30 fotogramas por segundo, llamar a IVideoFrameStep::Step con dwFrames establecido en 60 tardaría 2 segundos en ejecutarse. Todos los métodos de esta interfaz son asincrónicos, por lo que el control vuelve a la aplicación inmediatamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |
| Library | Strmiids.lib |