Metodo IReferenceClock::AdviseTime (strmif.h)

  • 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 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.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_INVALIDARG
 Valori di ora non validi.
E_OUTOFMEMORY
 Esito negativo.
E_POINTER
 Argomento puntatore NULL.

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

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IReferenceClock