IMFASFProfile::GetStream-Methode (wmcontainer.h)
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 |
|---|---|
|
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 |