IltmmDVDControl::NotifyParentalLevelChange

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl_NotifyParentalLevelChange(pDVD, Notify)

C++ Syntax

HRESULT NotifyParentalLevelChange(Notify)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

VARIANT_BOOL Notify;

/* notify */

Specifies if the DVD Navigator notifies the application when the parental level changes.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

Notify

A Boolean value that specifies the parental level change notification status. Possible values are:

 

Setting

Description

 

VARIANT_TRUE

Enable notification.

 

VARIANT_FALSE

Disable notification.

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

If the programmer calls this function with the Notify parameter set to VARIANT_TRUE, the DVD Navigator will notify the application when the DVD player attempts to play content that is at a higher parental level than the current parental level, set by calling IltmmDVDControl::SelectParentalLevel. The programmer should then ask for a username/password to enable the playing of the higher level content. The request is accepted or denied by calling IltmmDVDControl::AcceptParentalLevelChange.

For more detailed information, refer to the Microsoft documentation for IDvdControl2::SetOption.

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

Elements:

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

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