Método IMFPresentationTimeSource::GetUnderlyingClock (mfidl.h)

  • Artículo

Recupera el reloj subyacente que usa el origen de la hora de presentación para generar sus horas de reloj.

Sintaxis

HRESULT GetUnderlyingClock(
  [out] IMFClock **ppClock
);

Parámetros

[out] ppClock

Recibe un puntero a la interfaz IMFClock del reloj. El autor de la llamada debe liberar la interfaz .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_NO_CLOCK
 Este origen de hora no expone un reloj subyacente.

Comentarios

Un origen de tiempo de presentación debe admitir la detención, el inicio, la pausa y los cambios de velocidad. Sin embargo, en muchos casos, el origen de hora deriva sus horas de reloj de un reloj de hardware u otro dispositivo. El reloj subyacente siempre se está ejecutando y es posible que no admita cambios de velocidad.

Opcionalmente, un origen de hora puede exponer el reloj subyacente mediante la implementación de este método. El reloj subyacente siempre se está ejecutando, incluso cuando el origen de la hora de presentación está en pausa o detenido. (Por lo tanto, el reloj subyacente devuelve la marca MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING en el método IMFClock::GetClockCharacteristics ).

El reloj subyacente es útil si desea tomar decisiones basadas en las horas del reloj mientras el reloj de presentación está detenido o en pausa.

Si el origen de hora no expone un reloj subyacente, el método devuelve MF_E_NO_CLOCK.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

IMFPresentationTimeSource

Reloj de presentación