Método IVideoFrameStep::Step (strmif.h)
[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 |
|---|---|
|
Êxito. |
|
Não há suporte para a etapa de quadro. |
|
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 |