Método CBaseReferenceClock.GetTime

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetTime método recupera la hora de referencia actual. Este método implementa el método IReferenceClock::GetTime .

Sintaxis

HRESULT GetTime(
   REFERENCE_TIME *pTime
);

Parámetros

pTime

Puntero a una variable que recibe la hora actual, en unidades de 100 nanosegundos.

Valor devuelto

Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto Descripción
E_POINTER
 Argumento de puntero NULL.
S_FALSE
 El tiempo devuelto es el mismo que el valor anterior.
S_OK
 Correcto.

Observaciones

Este método llama al método CBaseReferenceClock::GetPrivateTime para determinar la hora del reloj real. Si la hora del reloj es estrictamente mayor que el valor anterior, GetTime usa la hora del reloj y devuelve S_OK. De lo contrario, GetTime usa el valor anterior y devuelve S_FALSE. Por lo tanto, el reloj interno puede ejecutarse hacia atrás durante un breve período, sin provocar que el tiempo de referencia se ejecute hacia atrás. En su lugar, la hora de referencia se "detendrá" en el mismo valor hasta que el reloj interno se ponga al día.

Requisitos

Requisito Value
Encabezado
Refclock.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseReferenceClock (clase)