Método CBaseReferenceClock.GetTime

  • Artigo

[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 GetTime método recupera a hora de referência atual. Esse método implementa o método IReferenceClock::GetTime .

Sintaxe

HRESULT GetTime(
   REFERENCE_TIME *pTime
);

Parâmetros

pTime

Ponteiro para uma variável que recebe a hora atual, em unidades de 100 nanossegundos.

Retornar valor

Retorna um dos valores HRESULT mostrados na tabela a seguir.

Código de retorno Descrição
E_POINTER
 Argumento de ponteiro NULL.
S_FALSE
 O tempo retornado é o mesmo que o valor anterior.
S_OK
 Êxito.

Comentários

Esse método chama o método CBaseReferenceClock::GetPrivateTime para determinar a hora real do relógio. Se a hora do relógio for estritamente maior que o valor anterior, GetTime usará a hora do relógio e retornará S_OK. Caso contrário, GetTime usa o valor anterior e retorna S_FALSE. Portanto, o relógio interno pode ser executado para trás por um curto período, sem fazer com que o tempo de referência seja executado para trás. Em vez disso, o tempo de referência "parará" com o mesmo valor até que o relógio interno seja atualizado.

Requisitos

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

Confira também

Classe CBaseReferenceClock