Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
HRESULT OnNavigationException(EDVDNavExceptionexcCode);
Parameters
- excCode
[in] EDVDNavException value describing the navigation error.
Return Values
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
OS Versions: Windows CE .NET 4.0 and later.
Header: Dvdnav.h, Dvdnav.idl.
Link Library: Ddvdids.lib.
See Also
Send Feedback on this topic to the authors