Share via

Método IMFClockStateSink::OnClockStart (mfidl.h)

  • Artículo

Se llama cuando se inicia el reloj de presentación.

Sintaxis

HRESULT OnClockStart(
  [in] MFTIME   hnsSystemTime,
  [in] LONGLONG llClockStartOffset
);

Parámetros

[in] hnsSystemTime

Hora del sistema en que se inició el reloj, en unidades de 100 nanosegundos.

[in] llClockStartOffset

La nueva hora de inicio del reloj, en unidades de 100 nanosegundos. Este parámetro también puede ser igual a PRESENTATION_CURRENT_POSITION, lo que indica que el reloj se ha iniciado o reiniciado desde su posición actual.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se llama a este método cuando se llama al método IMFPresentationClock::Start del reloj de presentación, con la siguiente excepción: Si el reloj está en pausa y se llama a Start con el valor PRESENTATION_CURRENT_POSITION, se llama a IMFClockStateSink::OnClockRestart en lugar de OnClockStart.

El reloj notifica al origen de la hora de presentación llamando al método OnClockStart del origen de hora. Esta llamada se produce de forma sincrónica dentro del método Start . Si el origen de hora devuelve un error de OnClockStart, el método Start del reloj de presentación devuelve un error y el cambio de estado no tiene lugar.

Para cualquier objeto que no sea el origen de la hora de presentación, se llama al método OnClockStart de forma asincrónica, una vez completado el cambio de estado. En ese caso, se omite el valor devuelto de este método.

El valor proporcionado en llClockStartOffset es el tiempo de presentación cuando se inicia el reloj, por lo que es relativo al inicio de la presentación. Los receptores multimedia no deben representar ningún dato con una hora de presentación anterior a llClockStartOffSet. Si una muestra coloca el desplazamiento (es decir, si el desplazamiento está comprendido entre las horas de inicio y detención de la muestra), el receptor debe recortar la muestra para que solo se representen los datos después de que se represente llClockStartOffset o simplemente quite la muestra.

Requisitos

   
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

IMFClockStateSink

MFTIME

Reloj de presentación