IltmmDVDControl::GetTitleParentalLevels

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl__getTitleParentalLevels(pDVD, 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., pLevels)

C++ Syntax

HRESULT GetTitleParentalLevels(Title, pLevels)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

long Title;

/* title */

long *pLevels;

/* pointer to a variable */

Retrieves the parental levels defined for the specified title.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

Title

The title from which the parental levels are retrieved. Possible values range from 1 to 99. Use –1 for the current title.

pLevels

Pointer to a variable that is updated with a value that represents the parental levels. For a list of possible values, refer to the ltmmDVD_PARENTAL_LEVEL constants. These constants can be combined using a bitwise OR.

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

Call IltmmDVDControl::get_PlayerParentalLevel to retrieve the current parental level for the DVD Navigator.

To retrieve the country/region code for the DVD Navigator, call IltmmDVDControl::get_PlayerParentalCountry.

Call IltmmDVDControl::SelectParentalCountry to set the parental country/region.

For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetTitleParentalLevels at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/idvdinfo2gettitleparentallevels.asp.

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:

IltmmDVDControl interface, IltmmDVDControl::get_PlayerParentalLevel, IltmmDVDControl::get_PlayerParentalCountry, IltmmDVDControl::SelectParentalCountry, IltmmDVDControl::SelectParentalLevel, IltmmDVDControl::AcceptParentalLevelChange, IltmmDVDControl::NotifyParentalLevelChange

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.

For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.