Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Deselects a stream in the presentation.
Syntax
HRESULT DeselectStream(
[in] DWORD dwDescriptorIndex
);
Parameters
[in] dwDescriptorIndex
The stream number to deselect, indexed from zero. To find the number of streams in the presentation, call the IMFPresentationDescriptor::GetStreamDescriptorCount method.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
dwDescriptorIndex is out of range. |
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.
This interface is available on the following platforms if the Windows Media Format 11 SDK redistributable components are installed:
- Windows XP with Service Pack 2 (SP2) and later.
- Windows XP Media Center Edition 2005 with KB900325 (Windows XP Media Center Edition 2005) and KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) installed.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | mfidl.h |
| Library | Mfuuid.lib |