IDVDNavigatorSink::OnNavigationException (Windows Embedded CE 6.0)

1/6/2010

This method is called when the navigation manager receives a navigation request that it cannot complete. This method returns a navigation exception code to the application.

Syntax

HRESULT OnNavigationException(
  EDVDNavException excCode
);

Parameters

• excCode
  [in] EDVDNavException value describing the navigation error.

Return Value

If the value of excCode is InsufficientParentalLevel, your player application must handle the process of setting a new parental level. The following list shows some possible implementation methods.

• Query the user for credentials to authorize an escalation of the parental level.
• Make an automatic escalation without user input.
• Ignore the request.

If the parental level is escalated, your application must set the new system parameter (SPRM) value and then set IDVDNavigatorSink::OnNavigationException to return S_OK. The DVD-Video API middleware will then try to play the program chain (PGC) again.

If after returning S_OK the parental level is still not high enough or IDVDNavigatorSink::OnNavigationException somehow failed to set the parental level correctly, the middleware will send another InsufficientParentalLevel notification. There are eight possible parental levels; therefore, the middleware will repeat this notification cycle up to eight times. After the eighth unsuccessful attempt, the middleware will go into the DVD_STOPPED state (see EDDVDPlaybackState).

If your application is unable to set a new parental level or chooses to ignore the notification, it should set IDVDNavigatorSink::OnNavigationException to return a value other than S_OK. Upon receiving this return value, the middleware will go into the DVD_STOPPED state.

If the value of excCode is anything other than InsufficientParentalLevel, the middleware ignores the return value from IDVDNavigatorSink::OnNavigationException.

Requirements

See Also

Reference

IDVDNavigatorSink