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
| Header | dvdnav.h, dvdnav.idl |
| Library | Ddvdids.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |