In This Topic ▼

IltmmDVDSubpictureStream::put_Selected

Summary

Sets the selected subpicture stream state.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmDVDSubpictureStream_put_Selected(pDVDSubpictureStream, newVal)
C++	HRESULT put_Selected(newVal)

Parameters

IltmmDVDSubpictureStream *pDVDSubpictureStream

Pointer to an IltmmDVDSubpictureStream interface.

VARIANT_BOOL newVal

Selected state value that indicates whether the subpicture stream is selected or not. Possible value are:

Setting	Description
VARIANT_TRUE	The subpicture stream is selected.
VARIANT_FALSE	The subpicture stream is not selected.

Returns

Value	Meaning
S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This property sets the subpicture stream state whether it is selected or not. Selecting a stream automatically unselects the other subpicture streams within that same title.

It is best to include the LEAD Video Subpicture Mixer with your application if you want to convert DVDs with subpicture information. This filter is needed during conversion if the DVD decoder does not combine the subpicture information with the video. If the DVD decoder does not combine the subpicture information with the video and the LEAD Video Subpicture Mixer is not present, it will appear as if you never selected any subpicture stream during conversion. This is true especially for Vista and Windows 7.