IDVDNavigatorSink::InitializeSystemParameters (Windows CE 5.0)
This method is called whenever system parameters (SPRM) must be initialized in response to the event categories described by the EDVDSParamEvent enumeration.
HRESULT InitializeSystemParameters( EDVDSParamEvent eventCode);
Parameters
eventCode
An element of the EDVDSParamEvent enumeration, which describes an event category that requires the player application to initialize the SPRMs.
Return Values
If the function succeeds, the return value is S_OK.
Remarks
Applications should respond to the events described by eventCode by setting the appropriate SPRMs.
The DVD Forum Specification documents the purpose of each SPRM and outlines which SPRMs should be set in response to an event. This specification also defines default values that can be used if the player cannot set a reasonable value, but these defaults are often not ideal.
If your application returns S_FALSE from this function, the DVD-Video API middleware will reset the SPRMs to their defaults. If your application does not handle a particular eventCode value, or if it returns an error, the DVD-Video API middleware continues with the current set of SPRM values.
The DVDSample code sample demonstrates how SPRMs are set based on events. For information about DVDSample, see DVD-Video API Samples.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Dvdnav.h, Dvdnav.idl.
Link Library: Ddvdids.lib.
See Also
IDVDNavigatorSink | EDVDSParamEvent | DVD-Video API Samples | About the DVD-Video API Documentation
Send Feedback on this topic to the authors