IMDSPDeviceControl::GetCapabilities

The GetCapabilities method retrieves the capabilities mask for the device with which this control interface is associated. The capabilities describe the methods of the device control that are supported by the media device.

Syntax

HRESULT GetCapabilities(
  DWORD*  pdwCapabilitiesMask
);

Parameters

pdwCapabilitiesMask

[out] Pointer to a double word containing the capabilities of the device. The following flags can be returned in this variable.

Flag	Description
MDM_DEVICECAP_CANPLAY	The media device can play MP3 audio.
MDM_DEVICECAP_CANSTREAMPLAY	The media device can play streaming audio directly from the host computer.
MDM_DEVICECAP_CANRECORD	The media device can record audio.
MDM_DEVICECAP_CANSTREAMRECORD	The media device can record streaming audio directly to the host computer.
MDM_DEVICECAP_CANPAUSE	The media device can pause during play or record operations.
MDM_DEVICECAP_CANRESUME	The media device can resume an operation from a pause command.
MDM_DEVICECAP_CANSTOP	The media device can stop playback before the end of a file.
MDM_DEVICECAP_CANSEEK	The media device can seek to a position other than the beginning of a file.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code	Description
E_INVALIDARG	The pdwCapabilitiesMask parameter is an invalid or NULL pointer.
E_FAIL	An unspecified error occurred.

See Also

IMDSPDeviceControl Interface

Previous

Next