Microsoft DirectX 9.0

MSVidWebDVD.NotifyParentalLevelChange Method

This topic applies to Windows XP Service Pack 1 only.

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

See Also