IConfigAviMux::SetMasterStream-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 SetMasterStream -Methode gibt einen Stream an, der zum Synchronisieren der anderen Datenströme in der Datei verwendet wird.

Syntax

HRESULT SetMasterStream(
  [in] LONG iStream
);

Parameter

[in] iStream

Gibt den Index des Datenstroms oder –1 an, um keinen master Datenstrom anzugeben. Avi Mux schreibt einen Stream für jeden angeschlossenen Eingabenadel. Stream Zahlen werden ab 0 (null) indiziert.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
E_INVALIDARG	Ungültiges Argument.
S_OK	Erfolg.

Hinweise

Wenn Sie Audio und Video aus zwei verschiedenen Quellen erfassen, verwenden Sie diese Methode, um die Streams zu synchronisieren. Datenströme, die aus separaten Erfassungsquellen stammen, können mit etwas unterschiedlichen Raten erfasst werden. Wenn Sie einen master Datenstrom angeben, passt avi Mux die Wiedergaberaten für die anderen Datenströme an, um etwaige Abweichungen auszugleichen.

Es wird empfohlen, den Audiodatenstrom als master Stream zu verwenden, da geringfügige Anpassungen der Videowiedergaberate weniger spürbar sind als Änderungen an der Audiowiedergaberate. Außerdem führt das Ändern der Audiowiedergaberate dazu, dass die Audiodaten vom Audiotreiber neu gestampt werden.

Diese Methode passt die Werte dwScale und dwRate in der AVISTREAMHEADER-Struktur an.

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

AVI RIFF-Dateireferenz

Fehler- und Erfolgscodes

IConfigAviMux-Schnittstelle