Método IMediaFilter::GetState (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 método GetState recupera o estado do filtro (em execução, parado ou pausado).

Sintaxe

HRESULT GetState(
  [in]  DWORD        dwMilliSecsTimeout,
  [out] FILTER_STATE *State
);

Parâmetros

[in] dwMilliSecsTimeout

Intervalo de tempo limite, em milissegundos. Para bloquear indefinidamente, use o valor INFINITE.

[out] State

Recebe um membro do tipo enumerado FILTER_STATE , indicando o estado do filtro.

Retornar valor

Retorna um valor HRESULT . Os valores possíveis incluem os mostrados na tabela a seguir.

Comentários

As transições de estado podem ser assíncronas. Se o filtro estiver fazendo a transição para um novo estado e o método atingir o tempo limite antes da transição ser concluída, o método retornará VFW_S_STATE_INTERMEDIATE.

Se um filtro não puder fornecer dados por algum motivo, ele retornará VFW_S_CANT_CUE. Os filtros de captura dinâmica retornam esse valor enquanto estão em pausa, pois não fornecem dados no estado em pausa.

Para obter mais informações, consulte Fluxo de Dados no Grafo de Filtro.

Requisitos

Confira também

Códigos de erro e êxito

Ibasefilter

IMediaFilter Interface