Compatibility Modes (Windows CE 5.0)

Send Feedback

Depending on the version of Windows CE, the Windows Media Player control implementation can operate in one of two modes to allow for backwards compatibility with the Microsoft ActiveMovie® control, as shown in the following table.

Mode Description Version support
MediaPlayer Supports nearly all methods, properties, and event notifications for the Windows Media Player control. Windows CE 3.0 through Windows CE .NET 4.1, Windows CE .NET 4.2 exclusively
ActiveMovie Supports nearly all methods, properties, and events supported for the ActiveMovie control. Windows CE 3.0 through Windows CE .NET 4.1 only

The CLSID used to create an instance of the control also determines the mode of operation.

Using the CLSID previously reserved for the ActiveMovie control creates an instance of the Windows Media Player control in that alternate mode. The control behaves similar to the older ActiveMovie control.

There are some points to consider when determining what mode to use:

  • The control only fires events appropriate to the mode in which it is instantiated.
  • The Windows Media Player error event is the only supported error event. There is no error handling in ActiveMovie mode.
  • Many ActiveMovie methods and properties have the same names as members of the Windows Media Player control. In these cases, the Windows Media Player functionality is provided no matter what compatibility mode the control is instantiated in.
  • The Microsoft® NetShow player control is not supported.

If the Windows Media Player control is created in ActiveMovie mode, Windows Media Player-specific methods or properties can be accessed as properties of the MediaPlayer property.

For example, if the control has been instantiated under the name AMovie1 in ActiveMovie mode, the Volume property could be accessed as follows.

AMovie1.MediaPlayer.Volume

If the Windows Media Player control is instantiated in MediaPlayer mode, the ActiveMovie property is exposed, providing access to methods and properties typically only available in that mode.

If a MediaPlayer control accessed the CurrentState property, it would do so as follows.

MediaPlayer1.ActiveMovie.CurrentState

Every method, property, and event listed in the reference includes a compatibility section that indicates whether that item is part of the Windows Media Player control, ActiveMovie control, or both.

See Also

Windows Media Player Control Application Development

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.