Condividi tramite


Metodo IReferenceClock::AdviseTime

[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita da Lettore di origine e Writer sink. Lettore di origine e Writer sink sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi Lettore di origine e Writer sink anziché Windows Media Format 11 SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo AdviseTime richiede una notifica asincrona trascorsa da un tempo.

Sintassi

HRESULT AdviseTime(
  [in]  REFERENCE_TIME rtBaseTime,
  [in]  REFERENCE_TIME rtStreamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD          *pdwAdviseCookie
);

Parametri

rtBaseTime [in]

Tempo di riferimento di base, in unità da 100 nanosecondi.

rtStreamTime [in]

Tempo di offset di flusso, in unità a 100 nanosecondi.

hEvent [in]

Gestire un evento, creato dal chiamante. Questo evento verrà segnalato al termine dell'ora specificata.

pdwAdviseCookie [out]

Puntatore a una variabile che riceve un identificatore per la richiesta. Questa operazione viene usata per identificare questa chiamata a AdviseTime in futuro, ad esempio, per annullare la richiesta.

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.
E_POINTER
Il parametro pdwAdviseCookie è NULL.
E_FAIL
Errore non specificato.

Vedi anche

Interfaccia IReferenceClock