IAMPushSource::SetStreamOffset-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetStreamOffset -Methode legt den Offset für Zeitstempel fest, die von diesem Filter generiert werden.

Syntax

HRESULT SetStreamOffset(
  [in] REFERENCE_TIME rtOffset
);

Parameter

[in] rtOffset

Neuer Streamoffset für den Filter.

Rückgabewert

Gibt S_FALSE zurück, wenn der angegebene Offset größer als der maximale bevorzugte Offset des Filters ist. Andernfalls gibt S_OK zurück, wenn erfolgreich oder ein HRESULT-Wert , der die Fehlerursache angibt.

Hinweise

Das Filterdiagramm ruft diese Methode auf, um den Streamoffset eines Filters anzupassen, um Streams mit unterschiedlichen Latenzwerten zu synchronisieren.

Wenn der Rückgabewert S_FALSE ist, unterstützt der Filter möglicherweise keinen Puffer, der groß genug für den angeforderten Offset ist. Sofern kein weiterer Puffer nachgeschaltet ist, können Daten verlorengehen. Um den maximalen bevorzugten Offset des Filters abzurufen, rufen Sie die IAMPushSource::GetMaxStreamOffset-Methode auf.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IAMPushSource-Schnittstelle