IltmmDVDSubpictureStream::put_Selected
#include "ltmm.h"
C Syntax |
HRESULT IltmmDVDSubpictureStream__put_Selected(pDVDSubpictureStream, newVal) |
C++ Syntax |
HRESULT put_Selected(newVal) |
IltmmDVDSubpictureStream *pDVDSubpictureStream; |
/* pointer to an interface */ |
VARIANT_BOOL newVal; |
/* selected state */ |
Sets the selected subpicture stream state.
Parameter |
Description |
|
pDVDSubpictureStream |
Pointer to an IltmmDVDSubpictureStream interface. |
|
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
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 The name for a group of related video files (called "Chapters") on your DVD. For example, for a DVD called "My Summer Vacation," you might have the titles "Water Skiing," "New Friends," and "Hiking." For each of those titles, you might have one or more different video files..
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 especially true for Vista and Windows 7.
Required DLLs and Libraries
LTMM For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
Elements: |
IltmmDVDSubpictureStream::get_Selected, IltmmDVDTitle::put_SelectedSubpictureStream |
Topics: |
Win32, x64
Example
For C example, refer to DVD Source Example.
For C++ example, refer to DVD Source Example.