MSVidWebDVD.NotifyParentalLevelChange Method
| Microsoft DirectShow 9.0 |
MSVidWebDVD.NotifyParentalLevelChange Method
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.
Syntax
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 Values
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 |
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.
Example
oVidWebDVD .NotifyParentalLevelChange( bNotify )
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 |
Requirements
Reference: Add a reference to MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
Library: Quartz.dll.
See Also