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 |
|---|---|
|
Il metodo è riuscito. |
|
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 |