In This Topic ▼

IltmmPlay::put_UseDVDSource

#include "ltmm.h"

C Syntax	HRESULT IltmmPlay_put_UseDVDSource (pPlay, newVal)
C++ Syntax	HRESULT put_UseDVDSource (newVal)

IltmmPlay *pPlay;	pointer to an interface
VARIANT_BOOL newVal;	flag

Sets a value that indicates whether the IltmmPlay object will use the DVD Source object when attempting to play a DVD image .

Parameter	Description
pPlay	Pointer to an IltmmPlay interface.
newVal	Flag that indicates whether the IltmmPlay object will use the DVD Source object when attempting to play a DVD image. Possible values are:
	Value	Meaning
	VARIANT_TRUE	Use the DVD Source object to play a DVD image.
	VARIANT_FALSE	Do not use the DVD Source object to play a DVD image.

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

Setting the UseDVDSource property in the play object to VARIANT_TRUE instructs the play object to use the DVD Source filter for DVD playback instead of the default DVD Navigator. Normally, for playback it is better to use the default DVD Navigator, because the DVD Navigator makes the playback act like a DVD (with menus). When the DVD Source filter is used, the DVD playback is more like the playback of a normal multimedia file. For example, the seek bar will function from the beginning of the selected playlist (edited through the ltmmDVDSource interfaces) to the end. There will be no menus. DVD Source was actually created for conversions. Using the DVD Source makes it possible to select the important parts of the video and ignore the rest. It also makes it possible to accurately preview the chapter selections being used for a conversion. Additionally, the DVD source allows you to programmatically select which audio track or subpicture stream to use. For example, a player application might want to automatically select the Spanish audio track or the French subtitles.

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.

Platforms

Win32, x64

Example

For a C example, refer to the DVD Source Example for C.

For a C++ example, refer to the DVD Source Example for C++.

Download our FREE evaluation

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

Multimedia Files You Must Include With Your Application (Redistributables)

Frequently Asked Questions

LEADTOOLS Multimedia Features

Add-on Modules

Programming with LEADTOOLS Multimedia

Appendix

LEADTOOLS Licensing

Elements:	IltmmPlay::get_UseDVDSource
Topics:	ltmmDVDSource Object
	IltmmDVDSource Interface
	IltmmPlay Interface
	Multimedia Function Groups