WMDM_PROP_CONFIG (deprecated)

  • Article
banner art

This is preliminary documentation and subject to change.

This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.

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. 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

Header: Defined in wmdm.idl.

Library: mssachlp.lib

See Also