Microsoft DirectX 9.0

IDvdControl2::AcceptParentalLevelChange

The AcceptParentalLevelChange method accepts or rejects a request from the DVD Navigator to play content at a higher parental management level.

Syntax

HRESULT AcceptParentalLevelChange(
  BOOL bAccept
);

Parameters

bAccept

[in] Flag that indicates whether the application accepts the parental management level change. Specify TRUE to accept the change and play the higher-level content, or FALSE to reject the change.

Return Values

Returns S_OK if successful, or an error code otherwise.

Remarks

A temporary parental management level (PML) command is a marker on the DVD disc indicating that the content that follows has a PML higher than the level specified for the title as a whole. This marker also contains instructions on where to branch depending on whether the change is accepted or rejected. If you specify FALSE, the DVD Navigator follows the rejected branch on the disc. If you specify TRUE, the DVD Navigator follows the branch to the higher-level content.

Use AcceptParentalLevelChange in conjunction with the SetOption method. The sequence of events is as follows: First, call SetOption(DVD_NotifyParentalLevelChange, TRUE) to tell the DVD Navigator to always wait after sending an EC_DVD_PARENTAL_LEVEL_CHANGE event notification to the application. In your event handler, implement code to determine whether to accept or reject the change, and then call AcceptParentalLevelChange to notify the DVD Navigator of the decision.

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