IMFMediaSink::AddStreamSink-Methode (mfidl.h)

  • Artikel

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