IPin::NewSegment-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die NewSegment -Methode benachrichtigt den Pin, dass nach diesem Aufruf empfangene Medienbeispiele als Segment mit einer gemeinsamen Startzeit, Stoppzeit und Rate gruppiert sind.
Anwendungen sollten diese Methode nicht aufrufen. Diese Methode wird von anderen Filtern aufgerufen.
Syntax
HRESULT NewSegment(
REFERENCE_TIME tStart,
REFERENCE_TIME tStop,
double dRate
);
Parameter
tStart
Startzeit des Segments relativ zur ursprünglichen Quelle in 100 Nanosekundeneinheiten.
tStop
Endzeit des Segments relativ zur ursprünglichen Quelle in 100 Nanosekundeneinheiten.
dRate
Rate, mit der dieses Segment verarbeitet werden soll, als Prozentsatz des ursprünglichen Tarifs.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK oder einen HRESULT-Wert zurück, der die Fehlerursache angibt.
Hinweise
Ein Quellfilter (oder Parserfilter) ruft diese Methode am Anfang jedes neuen Datenstroms und nach jedem Suchvorgang auf. Es ruft die -Methode auf dem Eingabenadel des Downstreamfilters auf, nachdem der vorherige Datenbatch übermittelt wurde und vor dem Aufruf von IMemInputPin::Receive mit neuen Daten. Der Downstreamfilter gibt den NewSegment Aufruf nachgeschaltet weiter.
Filter können Segmentinformationen verwenden, um Beispiele zu verarbeiten. Bei einigen Formaten ist es beispielsweise unmöglich, einen Deltaframe ohne den nächsten Keyframe zu rekonstruieren. Wenn die Stoppzeit für einen Deltaframe auftritt, muss der Quellfilter daher einige zusätzliche Frames senden. Der Decoderfilter bestimmt den endgültigen Frame basierend auf den Segmentinformationen. Die Segmentrate wird verwendet, um fortlaufende Datenquellen wie Audiodaten zu rendern. Beispielsweise verwendet der Audiorenderer die Samplingrate und die Segmentrate, um die Audiodaten ordnungsgemäß zu rendern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |