Compartir a través de

Método IVideoFrameStep::Step (strmif.h)

  • Artículo

[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
S_OK
 Correcto.
VFW_E_FRAME_STEP_UNSUPPORTED
 No se admite la ejecución paso a paso de fotogramas.
E_INVALIDARG
 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

Consulte también

Códigos de error y éxito

IVideoFrameStep (Interfaz)