IltmmDVDTitle::put_SelectedSubpictureStream

Summary

Sets the subpicture stream index to be selected.

Syntax

#include "ltmm.h"

Language Syntax
C HRESULT IltmmDVDTitle_put_SelectedSubpictureStream(pDVDTitle, newVal)
C++ HRESULT put_SelectedSubpictureStream(newVal)

Parameters

IltmmDVDTitle *pDVDTitle

Pointer to an IltmmDVDTitle interface.

long newVal

The subpicture stream index to be selected. This is 0 based index.

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 selects a subpicture stream. To get the count of available subpicture streams in the current title, call the IltmmDVDTitle::get_SubpictureStreamCount property.

To examine each subpicture stream use the IltmmDVDTitle::GetSubpictureStream to get each ltmmDVDSubpictureStream interface. To examine the subpicture stream information, decide which stream you want to use and then select it using the IltmmDVDSubpictureStream::put_Selected property.

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.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

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

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