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
Windows.Media.SystemMediaTransportControls.h
IDL
Windows.Media.SystemMediaTransportControls.idl

See also

IInspectable