Método IMFPresentationClock::Start (mfidl.h)
Inicia el reloj de presentación.
Sintaxis
HRESULT Start(
[in] LONGLONG llClockStartOffset
);
Parámetros
[in] llClockStartOffset
Hora inicial de inicio, en unidades de 100 nanosegundos. En el momento en que se llama al método Start , el método IMFPresentationClock::GetTime del reloj devuelve este valor y el tiempo del reloj aumenta desde allí. Si el valor es PRESENTATION_CURRENT_POSITION, el reloj comienza a partir de su posición actual. Use este valor si el reloj está en pausa y desea reiniciarlo desde la misma posición.
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 |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
No se estableció ningún origen de hora en este reloj. |
Comentarios
Este método es válido en todos los estados (detenido, en pausa o en ejecución).
Si el reloj está en pausa y se reinicia desde la misma posición (llClockStartOffset es PRESENTATION_CURRENT_POSITION), el reloj de presentación envía una notificación IMFClockStateSink::OnClockRestart . De lo contrario, el reloj envía una notificación IMFClockStateSink::OnClockStart .
El reloj de presentación inicia el cambio de estado llamando a OnClockStart o OnClockRestart en el origen de hora del reloj. Esta llamada se realiza sincrónicamente. Si se produce un error, el cambio de estado no se produce. Si la llamada se realiza correctamente, el estado cambia y el reloj notifica a los demás suscriptores de cambio de estado llamando a sus métodos OnClockStart o OnClockRestart . Estas llamadas se realizan de forma asincrónica.
Si el reloj ya se está ejecutando, llamar a Start de nuevo tiene el efecto de buscar el reloj en la nueva posición StartOffset .
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 |