#include "ltmm.h"
C Syntax |
HRESULT IltmmConvert__put_UseDVDSource (pConvert, newVal) |
C++ Syntax |
HRESULT put_UseDVDSource (newVal) |
IltmmConvert *pConvert; |
/* pointer to an interface */ |
VARIANT_BOOL newVal; |
/* flag */ |
Sets a value that indicates whether the IltmmConvert object will use the DVD Source object when attempting to play 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, 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...
Parameter |
Description |
|
pConvert |
Pointer to an IltmmConvert interface. |
|
newVal |
Flag that indicates whether the IltmmConvert 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 convert object to VARIANT_TRUE instructs the convert object to use the DVD Source filter instead of the default DVD Navigator. Using the DVD Source filter 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 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." selections being used for a conversion. Additionally, you can select which audio track to convert and which subtitle stream to include during conversion. For example, you can select the Spanish audio track or French subtitles if they available on the DVD.
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. |
Win32, x64
See Also
Elements: |
|
Topics: |
|
|
|
|
|
|
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++.