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 |
|---|---|
|
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 |