Metodo CBaseReferenceClock.GetTime

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetTime metodo recupera l'ora di riferimento corrente. Questo metodo implementa il metodo IReferenceClock::GetTime .

Sintassi

HRESULT GetTime(
   REFERENCE_TIME *pTime
);

Parametri

pTime

Puntatore a una variabile che riceve l'ora corrente, in unità di 100 nanosecondi.

Valore restituito

Restituisce uno dei valori HRESULT illustrati nella tabella seguente.

Codice restituito Descrizione
E_POINTER
 Argomento puntatore NULL.
S_FALSE
 L'ora restituita corrisponde al valore precedente.
S_OK
 Operazione completata.

Commenti

Questo metodo chiama il metodo CBaseReferenceClock::GetPrivateTime per determinare l'ora reale. Se l'ora dell'orologio è strettamente maggiore del valore precedente, GetTime usa l'ora dell'orologio e restituisce S_OK. In caso contrario, GetTime usa il valore precedente e restituisce S_FALSE. Pertanto, l'orologio interno può essere eseguito all'indietro per un breve periodo, senza causare l'esecuzione indietro del tempo di riferimento. Al contrario, l'ora di riferimento verrà "bloccata" con lo stesso valore fino a quando l'orologio interno non viene aggiornato.

Requisiti

Requisito Valore
Intestazione
Refclock.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseReferenceClock