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

Codici di errore e di esito positivo

Interfaccia IPin