Skip to content

Latest commit

 

History

History
153 lines (128 loc) · 4.33 KB

nf-mfidl-imfmediasink-removestreamsink.md

File metadata and controls

153 lines (128 loc) · 4.33 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mfidl.IMFMediaSink.RemoveStreamSink
IMFMediaSink::RemoveStreamSink (mfidl.h)
Removes a stream sink from the media sink.
IMFMediaSink interface [Media Foundation]
RemoveStreamSink method
IMFMediaSink.RemoveStreamSink
IMFMediaSink::RemoveStreamSink
RemoveStreamSink
RemoveStreamSink method [Media Foundation]
RemoveStreamSink method [Media Foundation]
IMFMediaSink interface
f99ee960-7fea-4867-bc24-d7e1d6fcafa5
mf.imfmediasink_removestreamsink
mfidl/IMFMediaSink::RemoveStreamSink
mf\imfmediasink_removestreamsink.htm
mf
f99ee960-7fea-4867-bc24-d7e1d6fcafa5
12/05/2018
IMFMediaSink interface [Media Foundation],RemoveStreamSink method, IMFMediaSink.RemoveStreamSink, IMFMediaSink::RemoveStreamSink, RemoveStreamSink, RemoveStreamSink method [Media Foundation], RemoveStreamSink method [Media Foundation],IMFMediaSink interface, f99ee960-7fea-4867-bc24-d7e1d6fcafa5, mf.imfmediasink_removestreamsink, mfidl/IMFMediaSink::RemoveStreamSink
mfidl.h
Windows
Windows Vista [desktop apps \| UWP apps]
Windows Server 2008 [desktop apps \| UWP apps]
Mfuuid.lib
Windows
19H1
IMFMediaSink::RemoveStreamSink
mfidl/IMFMediaSink::RemoveStreamSink
c++
APIRef
kbSyntax
COM
mfuuid.lib
mfuuid.dll
IMFMediaSink.RemoveStreamSink

IMFMediaSink::RemoveStreamSink

-description

Removes a stream sink from the media sink.

-parameters

-param dwStreamSinkIdentifier [in]

Identifier of the stream to remove. The stream identifier is defined when you call IMFMediaSink::AddStreamSink to add the stream sink.

-returns

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_INVALIDARG
This particular stream sink cannot be removed.
MF_E_INVALIDSTREAMNUMBER
The stream number is not valid.
MF_E_NOT_INITIALIZED
The media sink has not been initialized.
MF_E_SHUTDOWN
The media sink's Shutdown method has been called.
MF_E_STREAMSINKS_FIXED
This media sink has a fixed set of stream sinks. Stream sinks cannot be removed.

-remarks

After this method is called, the corresponding stream sink object is no longer valid. The IMFMediaSink::GetStreamSinkByIndex and IMFMediaSink::GetStreamSinkById methods will no longer return that stream sink. You can re-use the stream identifier if you add another stream (by calling AddStreamSink).

Not all media sinks support this method. If the media sink does not support this method, the IMFMediaSink::GetCharacteristics method returns the MEDIASINK_FIXED_STREAMS flag.

In some cases, the media sink supports this method but does not allow every stream sink to be removed. (For example, it might not allow stream 0 to be removed.)

-see-also

IMFMediaSink

Media Sinks