WMP SDK Interfaces

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

This section documents the COM interfaces exposed by the Windows Media Player ActiveX control and the Windows Media Player Mobile ActiveX control.

The accessor methods of the IWMPCore or IWMPPlayer interface are used to retrieve specific interfaces. These interfaces, in turn, may have accessor methods for retrieving further interfaces. Calling QueryInterface on one of these interfaces is only necessary when you retrieve the base version of an interface and want to call a method on a later version of the same interface.

Note

All methods and events are fully supported in Windows Media Player 10 Mobile and later unless explicitly stated otherwise.

The Windows Media Player control exposes the following interfaces.

Interface Description
_WMPOCXEvents Provides events originating from the Windows Media Player control to which an embedding program can respond.
IWMPCdrom Accesses a CD or DVD in a drive.
IWMPCdromBurn Provides methods to manage creating audio CDs.
IWMPCdromCollection Accesses a collection of CD or DVD drives.
IWMPCdromRip Provides methods to manage copying tracks from an audio CD.
IWMPClosedCaption Includes captions with a media clip.
IWMPClosedCaption2 Provides additional closed-captioning methods.
IWMPControls Represents the transport controls of Windows Media Player, such as Play, Stop, and Pause.
IWMPControls2 Provides additional control methods.
IWMPControls3 Provides additional control methods.
IWMPCore Retrieves pointers to other interfaces and accesses basic features of the control. This is the root interface for the Windows Media Player object model.
IWMPCore2 Provides additional core methods.
IWMPCore3 Provides additional core methods.
IWMPDVD Accesses the content menu of a DVD.
IWMPError Accesses a collection of IWMPErrorItem pointers.
IWMPErrorItem Provides information about errors.
IWMPErrorItem2 Provides additional error item methods.
IWMPEvents Exposes events that originate from the Windows Media Player control to which an embedding program can respond.
IWMPEvents2 Exposes events that originate from the Windows Media Player 10 control to which an embedding program can respond. These events are specifically used for device synchronization programs.
IWMPEvents3 Provides events related to CD ripping, CD burning, folder monitoring, and remote library services.
IWMPFolderMonitorServices Provides methods to enumerate, scan, and modify file folders that Windows Media Player monitors for digital media content.
IWMPGraphCreation Manages the DirectShow graph.
IWMPLibrary Represents a library.
IWMPLibraryServices Provides methods to enumerate libraries.
IWMPLibrarySharingServices Provides methods to manage library sharing.
IWMPMedia Sets and retrieves the properties of a media item.
IWMPMedia2 Provides additional methods to set and retrieve the properties of a media item.
IWMPMedia3 Provides additional methods to set and retrieve the properties of a media item.
IWMPMediaCollection Accesses a collection of IWMPMedia pointers.
IWMPMediaCollection2 Provides methods that supplement the IWMPMediaCollection interface.
IWMPMetadataPicture Retrieves information about the WM/Picture metadata attribute.
IWMPMetadataText Retrieves information about complex textual metadata attributes.
IWMPNetwork Sets and retrieves the properties of the network connection used by Windows Media Player.
IWMPPlayer Controls the behavior of the Windows Media Player control user interface.
IWMPPlayer2 Provides additional methods for controlling Windows Media Player.
IWMPPlayer3 Provides additional methods for controlling Windows Media Player.
IWMPPlayer4 Provides additional methods for controlling Windows Media Player.
IWMPPlayerApplication Switches between a remoted Windows Media Player control and the full mode of the Player. Designed for use by C++ programs that embed the control in remote mode.
IWMPPlayerServices Used by the host of a remoted control to manipulate the full mode of Windows Media Player. Designed for use with C++.
IWMPPlayerServices2 Sets the background processing priority.
IWMPPlaylist Creates and manages playlists.
IWMPPlaylistArray Accesses a collection of IWMPPlaylist pointers by index number.
IWMPPlaylistCollection Manipulates IWMPPlaylist and IWMPPlaylistArray pointers.
IWMPQuery Represents a compound query.
IWMPRemoteMediaServices Provides services to Windows Media Player from a program that hosts the Player control. Designed for use with C++.
IWMPRenderConfig Provides methods to specify or retrieve a value indicating whether playback happens only in the current process.
IWMPSettings Sets or retrieves Windows Media Player settings.
IWMPSettings2 Sets or retrieves Windows Media Player settings.
IWMPSkinManager Specifies the skin used with Windows Media Player.
IWMPStringCollection Accesses a collection of strings.
IWMPStringCollection2 Provides methods that supplement the IWMPStringCollection interface.
IWMPSyncDevice Represents a device that can synchronize digital media files with Windows Media Player 10.
IWMPSyncDevice2 Provides a method that supplements the IWMPSyncDevice interface.
IWMPSyncServices Enumerates available devices that can synchronize digital media files with Windows Media Player 10.
IWMPTranscodePolicy Provides a method implemented by DirectShow source filters to manage changing the format of digital media files.
IWMPVideoRenderConfig Provides a method that configures the enhanced video renderer used by Windows Media Player.

 

Object Model Reference for C++