Metodo IMediaSeeking::GetAvailable (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 GetAvailable metodo recupera l'intervallo di volte in cui la ricerca è efficiente.

Sintassi

HRESULT GetAvailable(
  [out] LONGLONG *pEarliest,
  [out] LONGLONG *pLatest
);

Parametri

[out] pEarliest

Puntatore a una variabile che riceve il primo tempo per una ricerca efficiente.

[out] pLatest

Puntatore a una variabile che riceve l'ora più recente per una ricerca efficiente.

Valore restituito

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

Codice restituito Descrizione
S_OK
Operazione completata.
E_NOTIMPL
Il metodo non è supportato.
E_POINTER
Argomento puntatore NULL.

Commenti

Questo metodo è destinato principalmente alla ricerca in flussi multimediali che potrebbero avere una latenza eccessiva, ad esempio i flussi inviati tramite una rete. I valori restituiti indicano i dati memorizzati nella cache già arrivati, che possono essere facilmente ricercati. Si presuppone che la ricerca di valori oltre questi parametri restituiti provocherà un ritardo mentre l'applicazione attende l'arrivo dei dati.

Tutti i valori temporali vengono espressi nel formato ora corrente. Il formato di ora predefinito è REFERENCE_TIME unità (100 nanosecondi). Per modificare i formati temporali, utilizzare il metodo IMediaSeeking::SetTimeFormat .

Requisiti

   
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 IMediaSeeking