IWMDMDeviceControl::Play

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();

Parameters

This method takes no parameters.

Return Values

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

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

Header: Defined in mswmdm.h.

Library: mssachlp.lib

See Also

• IWMDMDevice::GetFormatSupport
• IWMDMDeviceControl Interface
• IWMDMDeviceControl::GetCapabilities
• IWMDMDeviceControl::Seek
• IWMDMObjectInfo Interface