Condividi tramite


Metodo IMFPresentationClock::Start (mfidl.h)

Avvia l'orologio della presentazione.

Sintassi

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

Parametri

[in] llClockStartOffset

Ora iniziale, in 100-nanosecondi. Al momento della chiamata al metodo Start , il metodo FMPresentationClock::GetTime restituisce questo valore e l'ora viene incrementata da lì. Se il valore è PRESENTATION_CURRENT_POSITION, l'orologio inizia dalla posizione corrente. Usare questo valore se l'orologio è sospeso e si vuole riavviarlo dalla stessa posizione.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
MF_E_CLOCK_NO_TIME_SOURCE
Nessuna origine temporale impostata su questo orologio.

Commenti

Questo metodo è valido in tutti gli stati (arrestato, sospeso o in esecuzione).

Se l'orologio viene sospeso e riavviato dalla stessa posizione (llClockStartOffset è PRESENTATION_CURRENT_POSITION), l'orologio della presentazione invia una notifica FMClockStateSink::OnClockRestart . In caso contrario, l'orologio invia una notifica FMClockStateSink::OnClockStart .

L'orologio della presentazione avvia la modifica dello stato chiamando OnClockStart o OnClockRestart nell'origine ora dell'orologio. Questa chiamata viene effettuata in modo sincrono. Se ha esito negativo, la modifica dello stato non si verifica. Se la chiamata ha esito positivo, lo stato cambia e l'orologio notifica agli altri sottoscrittori di modifica dello stato chiamando i metodi OnClockStart o OnClockRestart . Queste chiamate vengono effettuate in modo asincrono.

Se l'orologio è già in esecuzione, la chiamata a Start ha l'effetto di cercare l'orologio nella nuova posizione startOffset .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfidl.h
Libreria Mfuuid.lib

Vedi anche

FMPresentationClock

Orologio presentazione