IMDSPDevice3::GetFormatCapability method (mswmdm.h)

The GetFormatCapability method retrieves information from a device about the values or ranges of values supported by the device for each aspect of a particular object format.

Syntax

HRESULT GetFormatCapability(
  [in]  WMDM_FORMATCODE        format,
  [out] WMDM_FORMAT_CAPABILITY *pFormatSupport
);

Parameters

[in] format

WMDM_FORMATCODE

Enumerated value representing inquired format.

[out] pFormatSupport

Returned WMDM_FORMAT_CAPABILITY structure containing the values or ranges of values supported for each aspect of a particular object format.

Return value

The method returns an HRESULT. All the interface methods in Windows Media Device Manager can return any of the following classes of error codes:

• Standard COM error codes
• Windows error codes converted to HRESULT values
• Windows Media Device Manager error codes

Remarks

This method can be called for any of the supported formats. The list of supported formats are represented by g_wszWMDMFormatsSupported device property.

For a particular format, this method should return all configurations of supported properties (for example, combinations of bit rate and sample rate). This information is expressed as a format capability. For detailed information, see WMDM_FORMAT_CAPABILITY.

Requirements

See also

IMDSPDevice3 Interface

IMDSPDevice3::GetProperty

WMDM_ENUM_PROP_VALID_VALUES_FORM

WMDM_FORMAT_CAPABILITY

WMDM_PROP_CONFIG

WMDM_PROP_DESC

WMDM_PROP_VALUES_ENUM

WMDM_PROP_VALUES_RANGE