WMDM_PROP_CONFIG structure

The WMDM_PROP_CONFIG structure describes a set of compatible property values across all the properties supported by the device for a particular format. This structure contains a number of property descriptions in an array of WMDM_PROP_DESC structures.

Syntax

typedef struct _WMDM_PROP_CONFIG {
  UINT           nPreference;
  UINT           nPropDesc;
  WMDM_PROP_DESC *pPropDesc;
} WMDM_PROP_CONFIG;

Members

nPreference

Device's level of preference for this configuration. The lowest value indicates the most preferred configuration.

nPropDesc

Number of property descriptions contained in this configuration. There is a single property description for each property supported for the specified format.

pPropDesc

Pointer to an array of WMDM_PROP_DESC structures containing property descriptions. The size of the array is equal to the value of nPropDesc. The application must free this memory when finished with it.

Remarks

The WMDM_FORMAT_CAPABILITY structure returned by IWMDMDevice3::GetFormatCapability for a particular format consists of a number of property configurations. WMDM_PROP_CONFIG structures describe those configurations.

A property configuration describes values for all the properties supported for a given format. The values of different properties in a single configuration are compatible with each other. For example, for an audio file, a configuration will include valid values of sample rate and valid values of the bit rate such that all combinations of these sample and bit rates can be played on the device.

The caller is required to free the memory used by pPropDesc. For an example of how to do this, see WMDM_FORMAT_CAPABILITY.

Requirements

Requirement Value
Header
Wmdm.idl

See also

IWMDMDevice3::GetFormatCapability

WMDM_ENUM_PROP_VALID_VALUES_FORM

WMDM_FORMAT_CAPABILITY

WMDM_PROP_DESC

WMDM_PROP_VALUES_ENUM

WMDM_PROP_VALUES_RANGE

Structures