Microsoft Windows CE 3.0  

Compatibility Modes

This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The Windows Media Player control implementation in Windows CE can operate in one of two modes to allow for backwards compatibility with the ActiveMovie control:

MediaPlayer mode
Supports nearly all methods, properties, and event notifications for the Windows Media Player control.
ActiveMovie mode
Supports nearly all methods, properties, and events supported for the ActiveMovie control.

The CLSID used to create an instance of the control 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 will behave 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 WMP 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 WMP functionality is provided no matter what compatibility mode the control is instantiated in.
  • The NetShow player control is not supported.

    Forward and Backward Compatibility

    If the WMP 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:


    Analogously, if the WMP control is instantiated in MediaPlayer mode, the ActiveMovie property is exposed, providing access to methods and properties normally only available in that mode. If a MediaPlayer control wishes to access the CurrentState property, it would do so as follows:


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

     Last updated on Tuesday, May 18, 2004

    © 2004 Microsoft Corporation. All rights reserved.