Metodo IReferenceClock::AdviseTime (strmif.h)

[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 AdviseTime metodo crea una richiesta di consulenza singola.

Sintassi

HRESULT AdviseTime(
  [in]  REFERENCE_TIME baseTime,
  [in]  REFERENCE_TIME streamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD_PTR      *pdwAdviseCookie
);

Parametri

[in] baseTime

Tempo di riferimento di base, in unità di 100 nanosecondi. Vedere la sezione Osservazioni.

[in] streamTime

Stream tempo di offset, in unità di 100 nanosecondi. Vedere la sezione Osservazioni.

[in] hEvent

Handle per un evento, creato dal chiamante.

[out] pdwAdviseCookie

Puntatore a una variabile che riceve un identificatore per la richiesta di avviso.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Commenti

Questo metodo crea una richiesta di consiglio one-shot per l'ora di riferimento rtBaseTime + rtStreamTime. La somma deve essere maggiore di zero e minore di MAX_TIME oppure il metodo restituisce E_INVALIDARG. All'ora richiesta, l'orologio segnala l'evento specificato nel parametro hEvent .

Per annullare la notifica prima del raggiungimento dell'ora, chiamare il metodo Unadvise e passare il valore pdwAdviseToken restituito da questa chiamata. Dopo che la notifica si è verificata, l'orologio lo cancella automaticamente, quindi non è necessario chiamare Unadvise. Tuttavia, non è un errore farlo.

Requisiti

Vedi anche

Codici di errore e di esito positivo

Interfaccia IReferenceClock