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 at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/idvdcontrol2setoption.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::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++.