IWMPEvents interface (wmp.h)

[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.]

The IWMPEvents interface provides events that originate from the Windows Media Player control. An embedding program can respond to these events. The events exposed by IWMPEvents are also exposed by the _WMPOCXEvents interface.

In addition to the methods inherited from IUnknown, the IWMPEvents interface exposes the following methods.

Method Description
AudioLanguageChange Occurs when the current audio language changes.
Buffering Occurs when the Windows Media Player control begins or ends buffering.
CdromMediaChange Occurs when a CD or DVD is inserted into or ejected from a CD or DVD drive.
Click Occurs when the user clicks a mouse button.
CurrentItemChange Occurs when the currentItem property of the IWMPControls interface changes value.
CurrentMediaItemAvailable Occurs when the current media item becomes available.
CurrentPlaylistChange Occurs when something changes within the current playlist.
CurrentPlaylistItemAvailable Occurs when the current playlist item becomes available.
Disconnect Reserved for future use.
DomainChange Occurs when the DVD domain changes.
DoubleClick Occurs when the user double-clicks a mouse button.
DurationUnitChange Reserved for future use.
EndOfStream Reserved for future use.
Error Occurs when the Windows Media Player control has an error condition.
KeyDown Occurs when a key is pressed.
KeyPress Occurs when a key is pressed and then released.
KeyUp Occurs when a key is released.
MarkerHit Occurs when a marker is reached.
MediaChange Occurs when a media item changes.
MediaCollectionAttributeStringAdded Occurs when an attribute is added to the library.
MediaCollectionAttributeStringChanged Occurs when an attribute in the library is changed.
MediaCollectionAttributeStringRemoved Occurs when an attribute is removed from the library.
MediaCollectionChange Occurs when the media collection changes.
MediaError Occurs when the Media object has an error condition.
ModeChange Occurs when a mode of Windows Media Player is changed.
MouseDown Occurs when a mouse button is pressed.
MouseMove Occurs when the mouse pointer is moved.
MouseUp Occurs when a mouse button is released.
NewStream Reserved for future use.
OpenPlaylistSwitch Occurs when a title on a DVD begins playing.
OpenStateChange Occurs when the Windows Media Player control changes state.
PlayerDockedStateChange Occurs when a remoted Windows Media Player control docks or undocks.
PlayerReconnect Occurs when a remoted Windows Media Player control reconnects to the Player.
PlaylistChange Occurs when a playlist changes.
PlaylistCollectionChange Occurs when something changes in the playlist collection.
PlaylistCollectionPlaylistAdded Occurs when a playlist is added to the playlist collection.
PlaylistCollectionPlaylistRemoved Occurs when a playlist is removed from the playlist collection.
PlaylistCollectionPlaylistSetAsDeleted Reserved for future use.
PlayStateChange Occurs when the play state of the Windows Media Player control changes.
PositionChange Occurs when the current position of the media has been changed.
ScriptCommand Occurs when a synchronized command or URL is received.
StatusChange Occurs when the status property changes value.
SwitchedToControl Occurs when a remoted Windows Media Player control switches to the docked state.
SwitchedToPlayerApplication Occurs when a remoted Windows Media Player control switches to the full mode of the Player.
Warning Reserved for future use.

Inheritance

The IWMPEvents interface inherits from the IUnknown interface.

Methods

The IWMPEvents interface has these methods.

 
IWMPEvents::AudioLanguageChange

The AudioLanguageChange event occurs when the current audio language changes.
IWMPEvents::Buffering

The Buffering event occurs when the Windows Media Player control begins or ends buffering.
IWMPEvents::CdromMediaChange

The CdromMediaChange event occurs when a CD or DVD is inserted into or ejected from a CD or DVD drive.
IWMPEvents::Click

The Click event occurs when the user clicks a mouse button.
IWMPEvents::CurrentItemChange

The CurrentItemChange event occurs when the user or the IWMPControls::put_CurrentItem method changes the current item value.
IWMPEvents::CurrentMediaItemAvailable

The CurrentMediaItemAvailable event occurs when the current media item becomes available.
IWMPEvents::CurrentPlaylistChange

The CurrentPlaylistChange event occurs when something changes within the current playlist.
IWMPEvents::CurrentPlaylistItemAvailable

The CurrentPlaylistItemAvailable event occurs when the current playlist item becomes available.
IWMPEvents::Disconnect

The Disconnect event is reserved for future use.
IWMPEvents::DomainChange

The DomainChange event occurs when the DVD domain changes.
IWMPEvents::DoubleClick

The DoubleClick event occurs when the user double-clicks a mouse button.
IWMPEvents::DurationUnitChange

The DurationUnitChange event is reserved for future use.
IWMPEvents::EndOfStream

The EndOfStream event is reserved for future use.
IWMPEvents::Error

The Error event occurs when the Windows Media Player control has an error condition..
IWMPEvents::KeyDown

The KeyDown event occurs when a key is pressed.
IWMPEvents::KeyPress

The KeyPress event occurs when a key is pressed and then released.
IWMPEvents::KeyUp

The KeyUp event occurs when a key is released.
IWMPEvents::MarkerHit

The MarkerHit event occurs when a marker is reached.
IWMPEvents::MediaChange

The MediaChange event occurs when a media item changes.
IWMPEvents::MediaCollectionAttributeStringAdded

The MediaCollectionAttributeStringAdded event occurs when an attribute is added to the library.
IWMPEvents::MediaCollectionAttributeStringChanged

The MediaCollectionAttributeStringChanged event occurs when an attribute value in the library is changed.
IWMPEvents::MediaCollectionAttributeStringRemoved

The MediaCollectionAttributeStringRemoved event occurs when an attribute is removed from the library.
IWMPEvents::MediaCollectionChange

The MediaCollectionChange event occurs when the media collection changes.
IWMPEvents::MediaError

The MediaError event occurs when the Media object has an error condition.
IWMPEvents::ModeChange

The ModeChange event occurs when a mode of the player is changed.
IWMPEvents::MouseDown

The MouseDown event occurs when a mouse button is pressed.
IWMPEvents::MouseMove

The MouseMove event occurs when the mouse pointer is moved.
IWMPEvents::MouseUp

The MouseUp event occurs when a mouse button is released.
IWMPEvents::NewStream

The NewStream event is reserved for future use.
IWMPEvents::OpenPlaylistSwitch

The OpenPlaylistSwitch event occurs when a title on a DVD begins playing.
IWMPEvents::OpenStateChange

The OpenStateChange event occurs when the Windows Media Player control changes state.
IWMPEvents::PlayerDockedStateChange

The PlayerDockedStateChange event occurs when a remoted Windows Media Player control docks or undocks.
IWMPEvents::PlayerReconnect

The PlayerReconnect event occurs when a remoted Windows Media Player control reconnects to the Player.
IWMPEvents::PlaylistChange

The PlaylistChange event occurs when a playlist changes.
IWMPEvents::PlaylistCollectionChange

The PlaylistCollectionChange event occurs when something changes in the playlist collection.
IWMPEvents::PlaylistCollectionPlaylistAdded

The PlaylistCollectionPlaylistAdded event occurs when a playlist is added to the playlist collection.
IWMPEvents::PlaylistCollectionPlaylistRemoved

The PlaylistCollectionPlaylistRemoved event occurs when a playlist is removed from the playlist collection.
IWMPEvents::PlaylistCollectionPlaylistSetAsDeleted

The PlaylistCollectionPlaylistSetAsDeleted event is reserved for future use.
IWMPEvents::PlayStateChange

The PlayStateChange event occurs when the play state of the Windows Media Player control changes.
IWMPEvents::PositionChange

The PositionChange event occurs when the current playback position within the media item has been changed.
IWMPEvents::ScriptCommand

The ScriptCommand event occurs when a synchronized command or URL is received.
IWMPEvents::StatusChange

The StatusChange event occurs when the status property changes value.
IWMPEvents::SwitchedToControl

The SwitchedToControl event occurs when a remoted Windows Media Player control switches to the docked state.
IWMPEvents::SwitchedToPlayerApplication

The SwitchedToPlayerApplication event occurs when a remoted Windows Media Player control switches to the full mode of the Player.
IWMPEvents::Warning

The Warning event is reserved for future use.

Requirements

Requirement Value
Target Platform Windows
Header wmp.h

See also

IWMPEvents2 Interface

Interfaces