Método IMediaFilter::GetState (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 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
S_OK
 Êxito.
E_POINTER
 Argumento de ponteiro NULL.
VFW_S_STATE_INTERMEDIATE
 Estado intermediário.
VFW_S_CANT_CUE
 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

Confira também

Códigos de erro e êxito

Ibasefilter

IMediaFilter Interface