Metodo IMediaSeeking::GetPreroll (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetPreroll metodo recupera la quantità di dati che verranno accodati prima della posizione iniziale.

Sintassi

HRESULT GetPreroll(
  [out] LONGLONG *pllPreroll
);

Parametri

[out] pllPreroll

Puntatore a una variabile che riceve l'ora di preroll, in unità del formato ora corrente.

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

La preroll è l'ora precedente alla posizione iniziale in cui i dispositivi di accesso nonrandom, ad esempio i lettori nastro, devono iniziare a rotolare.

Il valore restituito è espresso nel formato ora corrente. Il formato ora predefinito è REFERENCE_TIME unità (100 nanosecondi). Per modificare i formati di tempo, usare il metodo IMediaSeeking::SetTimeFormat .

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 errore e esito positivo

Interfaccia IMediaSeeking