IMFPresentationDescriptor::DeselectStream Method

Deselects a stream in the presentation.

Syntax

public:
HRESULT DeselectStream(
         DWORD dwDescriptorIndex
)

Parameters

dwDescriptorIndex
Type: DWORD 

The stream number to deselect, indexed from zero. To find the number of streams in the presentation, call the IMFPresentationDescriptor::GetStreamDescriptorCount method.

Return value

Type: HRESULT 

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

Return codes
Return code Description
S_OK The method succeeded.
E_INVALIDARG dwDescriptorIndex is out of range.

Refer to Media Foundation return codes.

Remarks

If a stream is deselected, no data is generated for that stream. To select the stream again, call IMFPresentationDescriptor::SelectStream.

To query whether a stream is selected, call IMFPresentationDescriptor::GetStreamDescriptorByIndex.

Requirements

Header: Declared in mfidl.h.

Library: Use mfuuid.lib.