IMDSPDevice3::GetFormatCapability method (mswmdm.h)

Article
02/22/2024

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