IMFMediaSink::AddStreamSink-Methode (mfidl.h)

Fügt der Mediensenke eine neue Streamsenke hinzu.

Syntax

HRESULT AddStreamSink(
  [in]  DWORD         dwStreamSinkIdentifier,
  [in]  IMFMediaType  *pMediaType,
  [out] IMFStreamSink **ppStreamSink
);

Parameter

[in] dwStreamSinkIdentifier

Bezeichner für den neuen Stream. Der Wert ist beliebig, muss aber eindeutig sein.

[in] pMediaType

Zeiger auf die IMFMediaType-Schnittstelle , wobei der Medientyp für den Stream angegeben wird. Dieser Parameter kann NULL sein.

[out] ppStreamSink

Empfängt einen Zeiger auf die IMFStreamSink-Schnittstelle der neuen Streamsenke. 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.
MF_E_INVALIDSTREAMNUMBER	Der angegebene Streambezeichner ist ungültig.
MF_E_SHUTDOWN	Die Shutdown-Methode der Mediensenke wurde aufgerufen.
MF_E_STREAMSINK_EXISTS	Es gibt bereits eine Streamsenke mit demselben Streambezeichner.
MF_E_STREAMSINKS_FIXED	Diese Mediensenke verfügt über einen festen Satz von Streamsenken. Neue Streamsenken können nicht hinzugefügt werden.

Hinweise

Nicht alle Mediensenken unterstützen diese Methode. Wenn die Mediensenke diese Methode nicht unterstützt, gibt die IMFMediaSink::GetCharacteristics-Methode das flag MEDIASINK_FIXED_STREAMS zurück.

Wenn pMediaTypeNULL ist, verwenden Sie die IMFMediaTypeHandler-Schnittstelle , um den Medientyp festzulegen. Rufen Sie IMFStreamSink::GetMediaTypeHandler auf, um einen Zeiger auf die Schnittstelle zu erhalten.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFMediaSink

Mediensenken