Interfaccia IMediaSeeking (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.
L'interfaccia IMediaSeeking contiene metodi per cercare una posizione all'interno di un flusso e per impostare la frequenza di riproduzione. Filter Graph Manager espone questa interfaccia e quindi singoli filtri o pin. Le applicazioni devono eseguire query su Filter Graph Manager per l'interfaccia .
Filter Graph Manager distribuisce qualsiasi IMediaSeeking chiamata a ogni filtro del renderer nel grafico. I filtri del renderer inviano la chiamata upstream ai filtri di origine. Questa sequenza di eventi garantisce che tutti i flussi rimangano sincronizzati. Se una delle chiamate distribuite restituisce un errore, Filter Graph Manager restituisce il primo valore di errore ricevuto, anche se alcune delle chiamate distribuite hanno esito positivo. Un'eccezione è E_NOTIMPL: Filter Graph Manager non restituisce E_NOTIMPL a meno che non sia stato restituito da tutte le chiamate distribuite.
Un'applicazione può cercare il grafico mentre il grafico è in qualsiasi stato (in esecuzione, sospeso o arrestato). Se il grafico è in esecuzione, Filter Graph Manager sospende il grafico prima di eseguire il comando seek. Quindi esegue di nuovo il grafico. Tutte le operazioni di ricerca sono indipendenti dalla frequenza di riproduzione corrente. La ricerca di operazioni causa lo scaricamento dei dati multimediali in sospeso dal grafico.
Per tutti i IMediaSeeking parametri che specificano l'ora, l'unità di tempo dipende dal formato dell'ora corrente. Per impostare il formato ora, chiamare il metodo IMediaSeeking::SetTimeFormat . I formati di ora sono identificatori univoci globali (GUID) definiti in uuids.h. Per altre informazioni, vedere GUID di formato ora.
Ereditarietà
L'interfaccia IMediaSeeking eredita dall'interfaccia IUnknown . IMediaSeeking include anche questi tipi di membri:
Metodi
L'interfaccia IMediaSeeking include questi metodi.
| IMediaSeeking::CheckCapabilities Il metodo CheckCapabilities esegue una query che indica se un flusso ha specificato funzionalità di ricerca. |
| IMediaSeeking::ConvertTimeFormat Il metodo ConvertTimeFormat converte da un formato una volta a un altro. |
| IMediaSeeking::GetAvailable Il metodo GetAvailable recupera l'intervallo di volte in cui la ricerca è efficiente. |
| IMediaSeeking::GetCapabilities Il metodo GetCapabilities recupera tutte le funzionalità di ricerca del flusso. |
| IMediaSeeking::GetCurrentPosition Il metodo GetCurrentPosition recupera la posizione corrente, rispetto alla durata totale del flusso. |
| IMediaSeeking::GetDuration Il metodo GetDuration ottiene la durata del flusso. |
| IMediaSeeking::GetPositions Il metodo GetPositions recupera la posizione corrente e la posizione di arresto, rispetto alla durata totale del flusso. |
| IMediaSeeking::GetPreroll Il metodo GetPreroll recupera la quantità di dati che verranno accodati prima della posizione iniziale. |
| IMediaSeeking::GetRate Il metodo GetRate recupera la frequenza di riproduzione. |
| IMediaSeeking::GetStopPosition Il metodo GetStopPosition recupera l'ora in cui la riproduzione verrà arrestata, in relazione alla durata del flusso. |
| IMediaSeeking::GetTimeFormat Il metodo GetTimeFormat recupera il formato dell'ora attualmente utilizzato per le operazioni di ricerca. |
| IMediaSeeking::IsFormatSupported Il metodo IsFormatSupported determina se è supportato un formato di ora specificato per le operazioni di ricerca. |
| IMediaSeeking::IsUsingTimeFormat Il metodo IsUsingTimeFormat determina se le operazioni seek usano attualmente un formato di ora specificato. |
| IMediaSeeking::QueryPreferredFormat Il metodo QueryPreferredFormat recupera il formato di tempo preferito per la ricerca. |
| IMediaSeeking::SetPositions Il metodo SetPositions imposta la posizione corrente e la posizione di arresto. |
| IMediaSeeking::SetRate Il metodo SetRate imposta la frequenza di riproduzione. |
| IMediaSeeking::SetTimeFormat Il metodo SetTimeFormat imposta il formato dell'ora per le operazioni di ricerca successive. |
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) |