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

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O Step método faz com que o grafo de filtro avance pelo número especificado de quadros.

Sintaxe

HRESULT Step(
  DWORD    dwFrames,
  IUnknown *pStepObject
);

Parâmetros

dwFrames

Especifica o número de quadros a serem ignoradas. Se dwFrames for 1, o grafo avançará um quadro. Se dwFrames for um número n maior que 1, o grafo ignorará n – 1 quadros e mostrará o nº quadro.

pStepObject

Ponteiro para uma interface no filtro que controlará a operação de etapa ou NULL. Especifique NULL para executar a etapa de quadro usando o filtro de renderizador no grafo. Se não for NULL, o objeto deverá implementar a interface IKsPropertySet e dar suporte à propriedade AM_KSPROPSETID_FrameStep. (Para obter mais informações, consulte Conjunto de propriedades frame stepping.) Se o grafo incluir um filtro personalizado que implementa a etapa de quadro, pStepObject poderá especificar um ponteiro para esse filtro.

Retornar valor

Retorna um HRESULT. Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
VFW_E_FRAME_STEP_UNSUPPORTED
 Não há suporte para a etapa de quadro.
E_INVALIDARG
 O parâmetro pStepObject é inválido.

Comentários

Quando a operação de etapa for concluída, esse método enviará uma notificação de evento EC_STEP_COMPLETE para o gerenciador de grafo de filtro, que a passará para o loop de eventos do aplicativo e definirá o grafo de filtro como um estado pausado.

Os quadros entram em tempo real, o que significa que, se o filme estiver sendo reproduzido em 30 quadros por segundo, chamar IVideoFrameStep::Step com dwFrames definidos como 60 levaria 2 segundos para ser executado. Todos os métodos nessa interface são assíncronos, portanto, o controle retorna ao aplicativo imediatamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IVideoFrameStep Interface