Metodo IReferenceClock::AdviseTime (strmif.h)

Articolo
03/02/2024

[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

Condividi tramite