Share via


WMDM_PROP_CONFIG

banner art

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;
  [size_is(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.

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 lowest preference value (in nPreference) indicates which configuration is best for the device. This configuration may be the one that a device can render most efficiently.

Requirements

Header: Defined in wmdm.idl.

Library: mssachlp.lib

See Also