IltmmDVDSource::put_Selected

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDSource_put_Selected(pDVDSource, newVal)

C++ Syntax

HRESULT put_Selected(newVal)

 

IltmmDVDSource *pDVDSource;

/* pointer to an interface */

long newVal;

/* selected state */

Sets a value which indicates whether none or all of the disc should be selected..

Parameter

Description

pDVDSource

Pointer to an IltmmDVDSource interface.

newVal

An ltmmDVDSourceSelectedState constant that indicates how much of the disc should be 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 selects items on the disc according to the value of newVal. To select the entire disc, pass the ltmmDVDSource_Selected value. To remove all selections, pass the  ltmmDVDSource_Unselected value. If  the ltmmDVDSource_Partially_Selected value is passed the entire disc will be selected, and the property value then becomes ltmmDVDSource_Selected.

To retrieve a value that indicates how much of the disc is selected, call IltmmDVDSource::get_Selected.

Note that both IltmmConvert::put_UseDVDSource and  IltmmPlay::put_UseDVDSource should be called with pVal set to VARIANT_TRUE before specifying the DVD source image to force the player or converter to use the IltmmDVDSource interface when attempting to play or convert a DVD image A set of files that contain all of the video and audio content for a DVD, organized with a table of contents (optional). See also: 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., Chapter The name for each individual video file on a DVD. For example, under the title "Water Skiing", you might have the chapters "My first try," "My first wreck," and "My first jump.", ISO Image An ISO image (.iso) is a disk image of a file system. It includes data files that are contained in the ISO image along with filesystem metadata. ISO images are an alternative to physical media for distribution of a "DVD" over the Internet. Most operating systems allow ISO images images to be "played" as if they were physical discs. See also: DVD Image...

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

See Also

Functions:

IltmmDVDSource::get_SelectedDuration, IltmmDVDSource::get_Selected

Topics:

Multimedia Function Groups

Example

For C example, refer to DVD Source for C or Convert DVD with Subtiitles for C

For C++ example, refer to DVD Source for C++ or Convert DVD with Subtiitles for C++