ISystemMediaTransportControls interface
[The feature associated with this page, Media Transport Controls, is a legacy feature. It has been superseded by System Media Transport Controls. System Media Transport Controls has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use System Media Transport Controls instead of Media Transport Controls, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Represents an object that enables integrate with the system media transport controls and support for media commands.
Members
The ISystemMediaTransportControls interface inherits from IInspectable. ISystemMediaTransportControls also has these types of members:
Methods
The ISystemMediaTransportControls interface has these methods.
| Method | Description |
|---|---|
| add_ButtonPressed | Adds an event handler for the ButtonPressed event. |
| add_PropertyChanged | Adds an event handler for the PropertyChanged event. |
| get_DisplayUpdater | Gets the display updater for the ISystemMediaTransportControls which enables updating the information displayed about the currently playing media item. |
| get_IsChannelDownEnabled | Gets a value that indicates if the channel down button is enabled. |
| get_IsChannelUpEnabled | Gets a value that indicates if the channel up button is enabled. |
| get_IsEnabled | Gets a value that indicates if the system media transport controls are enabled for the calling app. |
| get_IsFastForwardEnabled | Gets a value that indicates if the fast forward button is enabled. |
| get_IsNextEnabled | Gets a value that indicates if the next button is enabled. |
| get_IsPauseEnabled | Gets a value that indicates if the pause button is enabled. |
| get_IsPlayEnabled | Gets a value that indicates if the play button is enabled. |
| get_IsPreviousEnabled | Gets a value that indicates if the previous button is enabled. |
| get_IsRecordEnabled | Gets a value that indicates if the record button is enabled. |
| get_IsRewindEnabled | Gets a value that indicates if the rewind button is enabled. |
| get_IsStopEnabled | Gets a value that indicates if the stop button is enabled. |
| get_PlaybackStatus | Gets the media playback status. |
| get_SoundLevel | Gets the sound level of the media for the capture and render streams. |
| put_IsChannelDownEnabled | Sets a value that specifies if the channel down button should be enabled. |
| put_IsChannelUpEnabled | Sets a value that specifies if the channel up button should be enabled. |
| put_IsEnabled | Sets a value that specifies if the system media transport controls should be enabled for the calling app. |
| put_IsFastForwardEnabled | Sets a value that specifies if the fast forward button should be enabled. |
| put_IsNextEnabled | Sets a value that specifies if the fast next button should be enabled. |
| put_IsPauseEnabled | Sets a value that specifies if the pause button should be enabled. |
| put_IsPlayEnabled | Sets a value that specifies if the play button should be enabled. |
| put_IsPreviousEnabled | Sets a value that specifies if the previous button should be enabled. |
| put_IsRecordEnabled | Sets a value that specifies if the record button should be enabled. |
| put_IsRewindEnabled | Sets a value that specifies if the rewind button should be enabled. |
| put_IsStopEnabled | Sets a value that specifies if the stop button should be enabled. |
| put_PlaybackStatus | Sets the media playback status. |
| remove_ButtonPressed | Removes the specified event handler for the ButtonPressed event. |
| remove_PropertyChanged | Removes the specified event handler for the PropertyChanged event. |
Remarks
Get an instance of this interface by calling ISystemMediaTransportControlsInterop::GetForWindow and passing in the HWND for the top-level window of your app.
Requirements
| Minimum supported client |
Windows 10 [desktop apps only] |
| Minimum supported server |
Windows Server 2016 [desktop apps only] |
| Header |
|
| IDL |
|