Share via


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

DVD-Video API Samples

Reference

IDVDNavigatorSink
EDVDSParamEvent

Concepts

About the DVD-Video API Documentation