In This Topic ▼

IltmmDVDSource::put_Selected

Summary

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

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmDVDSource_put_Selected(pDVDSource, newVal)
C++	HRESULT put_Selected(newVal)

Parameters

IltmmDVDSource *pDVDSource

Pointer to an IltmmDVDSource interface.

long newVal

An ltmmDVDSourceSelectedState constant that indicates how much of the disc should be selected.

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 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.