Compartilhar via


Método CBaseRenderer.GetState

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 GetState método recupera o estado dos filtros (em execução, parado ou pausado).

Sintaxe

HRESULT GetState(
   DWORD        dwMilliSecsTimeout,
   FILTER_STATE *State
);

Parâmetros

dwMilliSecsTimeout

Intervalo de tempo limite, em milissegundos.

State

Ponteiro para uma variável que recebe um membro do FILTER_STATE tipo enumerado, indicando o estado do filtro.

Retornar valor

Retorna um dos valores HRESULT mostrados na tabela a seguir.

Código de retorno Descrição
S_OK
Êxito.
VFW_S_STATE_INTERMEDIATE
O filtro está fazendo a transição para o estado indicado.
E_POINTER
Argumento de ponteiro NULL.

Comentários

Esse método substitui o método CBaseFilter::GetState . Quando o renderizador é pausado, ele não conclui a transição de estado até receber um exemplo a ser renderizado. Se o tempo limite expirar antes da transição de estado ser concluída, o método retornará VFW_S_STATE_INTERMEDIATE.

Requisitos

Requisito Valor
parâmetro
Renbase.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseRenderer