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.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Argumento de ponteiro NULL. |
|
Estado intermediário. |
|
O filtro está ativo, mas não pode fornecer dados. |
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
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |