IltmmConvert::get_DVDControl

#include "ltmm.h"

C Syntax

HRESULT IltmmConvert__get_DVDControl(pConvert, pVal)

C++ Syntax

HRESULT get_DVDControl(pVal)

 

IltmmConvert * pConvert;

/* pointer to an interface */

IltmmDVDControl ** pVal;

/* address of a pointer to an interface */

Retrieves the registered DVD control object.

Parameter

Description

pConvert

Pointer to an IltmmConvert interface.

pVal

Pointer to a variable that receives the registered DVD control interface pointer.

Returns

S_OK

The function ran successfully.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

The IltmmDVDControl Interface is used to control the playback and search mechanisms of a DVD 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. that contain one or more movies. For more information, refer to IltmmDVDControl.

If the function succeeds, the user should release the returned interface pointer by calling the interface’s Release method.

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.

See Also

Elements:

IltmmConvert interface, IltmmDVDControl Interface

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmConvert::get_DVDControl Example for C.

For a C++ example, refer to IltmmConvert::get_DVDControl Example for C++.