Share via


MSVidWebDVD.NotifyParentalLevelChange Method

Note  This topic applies to Windows XP Service Pack 1 or later.

The NotifyParentalLevelChange method enables or disables playback stop for temporary parental management level commands.

VidWebDVD.NotifyParentalLevelChange(
   bNotify As Boolean
)

Parameters

  • bNotify
    Specifies a Boolean value indicating whether or not the application should be notified when the reader encounters video segments with a rating more restrictive than the overall rating for the disc.

Return Value

This method does not return a value.

Error Codes

If the property fails, Err.Number may be set to one of the following values.

Value Description
E_UNEXPECTED Unspecified error

Valid Domains

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name Valid Domains
None All

Remarks

The EC_DVD_PLAYBACK_RATE_CHANGE notification is sent regardless of whether or not this method has been set to True or False. However, this value determines the behavior of the DVD Navigator filter when it encounters different temporary parental levels.

If NotifyParentalLevelChange is set to True and the player encounters a temporary management level more restrictive than the player's current value, the DVD Navigator filter will pause playback and wait for the AcceptParentalLevelChange method to either allow or prevent playback of the restricted content. It is up to the application to create a message box or otherwise reject or accept the new level. If the level change is rejected, playback will either branch to a permissible path specified by the disc, or halt playback if no path is specified.

If NotifyParentalLevelChange is set to False, the application will automatically branch to a permissable path specified by the disc, or stop if no permissable path is specified.

Call this method during initialization of your application if you need to handle temporary parental management level commands from the disc. To disable parental management after it is enabled, call this method with an argument of False. For more details on parental management, see AcceptParentalLevelChange.

NotifyParentalLevelChange is set to False by default.

Examples

oVidWebDVD.NotifyParentalLevelChange(bNotify)

Requirements

Type Library Use MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
DLL Requires Quartz.dll.

See Also

AcceptParentalLevelChange
Enforcing Parental Management Levels
MSVidWebDVD Object
Parental Management
PlayerParentalCountry
PlayerParentalLevel
SelectParentalCountry
SelectParentalLevel
TitleParentalLevels

Send comments about this topic to Microsoft

Build date: 12/4/2008