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
For an extensive list of possible error codes, see 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

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

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