Metodo IPin::NewSegment (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 NewSegment metodo notifica al pin che i campioni multimediali ricevuti dopo questa chiamata vengono raggruppati come segmento, con un'ora di inizio, un'ora di arresto e una frequenza comuni.
Le applicazioni non devono chiamare questo metodo. Questo metodo viene chiamato da altri filtri.
Sintassi
HRESULT NewSegment(
REFERENCE_TIME tStart,
REFERENCE_TIME tStop,
double dRate
);
Parametri
tStart
Ora di inizio del segmento, rispetto all'origine originale, in unità di 100 nanosecondi.
tStop
Ora di fine del segmento, rispetto all'origine originale, in unità di 100 nanosecondi.
dRate
Frequenza con cui questo segmento deve essere elaborato, come percentuale del tasso originale.
Valore restituito
Restituisce S_OK se ha esito positivo o un valore HRESULT che indica la causa dell'errore.
Commenti
Un filtro di origine (o filtro parser) chiama questo metodo all'inizio di ogni nuovo flusso e dopo ogni operazione di ricerca. Chiama il metodo sul pin di input del filtro downstream, dopo aver recapitato il batch di dati precedente e prima di chiamare IMemInputPin::Receive con i nuovi dati. Il filtro downstream propaga la NewSegment chiamata downstream.
I filtri possono usare le informazioni sui segmenti per elaborare esempi. Ad esempio, con alcuni formati non è possibile ricostruire un frame differenziale senza il fotogramma chiave successivo. Pertanto, se il tempo di arresto si verifica in un frame differenziale, il filtro di origine deve inviare alcuni fotogrammi aggiuntivi. Il filtro del decodificatore determina il frame finale in base alle informazioni sul segmento. La frequenza dei segmenti viene usata per eseguire il rendering di origini dati continue, ad esempio dati audio. Ad esempio, il renderer audio usa la frequenza di campionamento e la frequenza dei segmenti per eseguire correttamente il rendering dei dati audio.
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
Flusso di dati nel grafico dei filtri