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 .

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:

Multimedia Function Groups

Platforms

Win32, x64

Example

For C example, refer to DVD Source Example.

For C++ example, refer to DVD Source Example.

Help Version 21.0.2021.7.19
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.