IPin::NewSegment-Methode (strmif.h)

  • Artikel

[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

Weitere Informationen

Datenfluss im Filtergraphen

Fehler- und Erfolgscodes

IPin-Schnittstelle