IMFASFProfile::GetStreamByNumber-Methode (wmcontainer.h)

Ruft ein ASF-Streamkonfigurationsobjekt (Advanced Systems Format) für einen Stream im Profil ab. Diese Methode verweist auf den Stream nach Streamnummer anstelle des Streamindexes.

Syntax

HRESULT GetStreamByNumber(
  [in]  WORD               wStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Parameter

[in] wStreamNumber

Die Streamnummer, für die der Schnittstellenzeiger abgerufen werden soll.

[out] ppIStream

Empfängt einen Zeiger auf die IMFASFStreamConfig-Schnittstelle des ASF-Streamkonfigurationsobjekts. Der Aufrufer muss die Schnittstelle freigeben.

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

Weitere Informationen

ASF-Profil

IMFASFProfile

IMFASFProfile::GetStream

IMFASFProfile::SetStream

IMFASFStreamConfig