IWMPEvents3 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 IWMPEvents3 interface provides access to events originating from the Windows Media Player 11 control so that an application that has this control embedded in it can respond to these events. The events exposed by IWMPEvents3 are also exposed by the _WMPOCXEvents interface.
The events provided by IWMPEvents3 extend the set of events provided by IWMPEvents and IWMPEvents2 by adding events related to CD ripping, CD burning, folder monitoring, and remote library services.
In addition to the methods inherited from IWMPEvents2, the IWMPEvents3 interface exposes the following methods.
| Method | Description |
|---|---|
| CdromBurnError | Occurs when a generic error happens during a CD burning operation. |
| CdromBurnMediaError | Occurs when an error happens while burning an individual media item to a CD. |
| CdromBurnStateChange | Occurs when a CD burning operation changes state. |
| CdromRipMediaError | Occurs when an error happens while ripping an individual track from a CD. |
| CdromRipStateChange | Occurs when a CD ripping operation changes state. |
| FolderScanStateChange | Occurs when a folder monitoring operation changes state. |
| LibraryConnect | Occurs when a library becomes available. |
| LibraryDisconnect | Occurs when a library is no longer available. |
| MediaCollectionMediaAdded | Occurs when a media item is added to the local library. |
| MediaCollectionMediaRemoved | Occurs when a media item is removed from the local library. |
| StringCollectionChange | Occurs when a string collection changes. |
- _WMPOCXEvents Interface
- Handling Events in C++
- Interfaces
- IWMPEvents Interface
- IWMPEvents2 Interface
| Previous | Next |
Inheritance
The IWMPEvents3 interface inherits from the IWMPEvents2 interface.
Methods
The IWMPEvents3 interface has these methods.
| IWMPEvents3::CdromBurnError The CdromBurnError event occurs when a generic error happens during a CD burning operation. |
| IWMPEvents3::CdromBurnMediaError The CdromBurnMediaError event occurs when an error happens while burning an individual media item to a CD. |
| IWMPEvents3::CdromBurnStateChange The CdromBurnStateChange event occurs when a CD burning operation changes state. |
| IWMPEvents3::CdromRipMediaError The CdromRipMediaError event occurs when an error happens while ripping an individual track from a CD. |
| IWMPEvents3::CdromRipStateChange The CdromRipStateChange event occurs when a CD ripping operation changes state. |
| IWMPEvents3::FolderScanStateChange The FolderScanStateChange event occurs when a folder monitoring operation changes state. |
| IWMPEvents3::LibraryConnect The LibraryConnect event occurs when a library becomes available. |
| IWMPEvents3::LibraryDisconnect The LibraryDisconnect event occurs when a library is no longer available. |
| IWMPEvents3::MediaCollectionMediaAdded The MediaCollectionMediaAdded event occurs when a media item is added to the local library. |
| IWMPEvents3::MediaCollectionMediaRemoved The MediaCollectionMediaRemoved event occurs when a media item is removed from the local library. |
| IWMPEvents3::StringCollectionChange The StringCollectionChange event occurs when a string collection changes. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | wmp.h |