IDVDNavigatorSink::InitializeSystemParameters (Windows Embedded CE 6.0)
1/6/2010
This method is called whenever system parameters (SPRM) must be initialized in response to the event categories described by the EDVDSParamEvent enumeration.
Syntax
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 Value
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.
Requirements
Header | dvdnav.h, dvdnav.idl |
Library | Ddvdids.lib |
Windows Embedded CE | Windows CE 5.0 and later |
See Also
Tasks
Reference
IDVDNavigatorSink
EDVDSParamEvent