IMFASFProfile::GetStream-Methode (wmcontainer.h)

Artikel
03/04/2024

Ruft einen Stream aus dem Profil nach Streamindex ab und/oder ruft die Streamnummer für einen Streamindex ab.

Syntax

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Parameter

[in] dwStreamIndex

Der Index des abzurufenden Streams. Stream Indizes sind sequenziell und nullbasiert. Sie können die Anzahl der Streams im Profil abrufen, indem Sie die METHODE IMFASFProfile::GetStreamCount aufrufen.

[out] pwStreamNumber

Empfängt die Streamnummer des angeforderten Datenstroms. Stream Zahlen sind einsbasiert und nicht unbedingt sequenziell. Dieser Parameter kann auf NULL festgelegt werden, wenn die Streamnummer nicht erforderlich ist.

[out] ppIStream

Empfängt einen Zeiger auf die IMFASFStreamConfig-Schnittstelle des ASF-Streamkonfigurationsobjekts. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann NULL sein, wenn Sie die Streamnummer abrufen möchten, ohne auf die Streamkonfiguration zuzugreifen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Diese Methode erstellt keine Kopie des Streamkonfigurationsobjekts. Der abgerufene Zeiger verweist auf das Objekt innerhalb des Profilobjekts. Sie dürfen mit diesem Zeiger keine Änderungen am Streamkonfigurationsobjekt vornehmen, da sich dies auf unerwartete Weise auf das Profilobjekt auswirken kann.

Um die Konfiguration des Streamkonfigurationsobjekts im Profil zu ändern, müssen Sie zuerst das Streamkonfigurationsobjekt klonen, indem Sie IMFASFStreamConfig::Clone aufrufen. Nehmen Sie alle erforderlichen Änderungen am Klon des Objekts vor, und fügen Sie dann das aktualisierte Objekt hinzu, indem Sie die IMFASFProfile::SetStream-Methode aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcontainer.h
Bibliothek	Mfuuid.lib