Edit

IWMDMDeviceControl::Play method (mswmdm.h)

  • Article

The Play method begins playing at the current seek position. If the IWMDMDeviceControl::Seek method has not been called, then playing begins at the beginning of the first file, and the play length is not defined.

Syntax

HRESULT Play();

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
E_BUSY
 The device is busy.
WMDM_E_NOTSUPPORTED
 The play function is not implemented on this device.
E_FAIL
 An unspecified error occurred.

Remarks

This method is used to invoke both device playback (playing an audio track on a storage medium of the media device) and streaming audio playback (streaming audio data from the user's computer to the media device, where it is played). The Seek method determines the form of playback that occurs.

Some devices do not support either device playback or streaming audio playback. Before attempting to start playback of a particular type, the GetCapabilities method must be called. If unsupported playback is attempted, this method returns WMDM_E_NOTSUPPORTED.

To determine before invoking the play operation whether an audio format can be played by the media device, you can call the GetFormatSupport method.

Requirements

Requirement Value
Target Platform Windows
Header mswmdm.h
Library Mssachlp.lib

See also

IWMDMDevice::GetFormatSupport

IWMDMDeviceControl Interface

IWMDMDeviceControl::GetCapabilities

IWMDMDeviceControl::Seek

IWMDMObjectInfo Interface