Metodo IMFPresentationTimeSource::GetUnderlyingClock (mfidl.h)
Recupera l'orologio sottostante usato dall'origine dell'ora della presentazione per generare i tempi dell'orologio.
Sintassi
HRESULT GetUnderlyingClock(
[out] IMFClock **ppClock
);
Parametri
[out] ppClock
Riceve un puntatore all'interfaccia FMClock dell'orologio. Il chiamante deve rilasciare l'interfaccia.
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. |
|
Questa origine temporale non espone un orologio sottostante. |
Commenti
Un'origine temporale di presentazione deve supportare l'arresto, l'avvio, la sospensione e le modifiche della frequenza. Tuttavia, in molti casi l'origine temporale deriva i tempi di orologio da un orologio hardware o da un altro dispositivo. L'orologio sottostante è sempre in esecuzione e potrebbe non supportare le modifiche della frequenza.
Facoltativamente, un'origine temporale può esporre l'orologio sottostante implementando questo metodo. L'orologio sottostante è sempre in esecuzione, anche quando l'origine dell'ora di presentazione viene sospesa o arrestata. Pertanto, l'orologio sottostante restituisce il flag MFCLOCK_CHARACTERISTICS_FLAG_ALWAYS_RUNNING nel metodo FMClock::GetClockCharacteristics .
L'orologio sottostante è utile se si desidera prendere decisioni in base all'ora dell'orologio mentre l'orologio della presentazione viene arrestato o sospeso.
Se l'origine temporale non espone un orologio sottostante, il metodo restituisce MF_E_NO_CLOCK.
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 |