IDVDNavigatorSink::OnNavigationException (Windows CE 5.0)
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