Share via

WMDM_PROP_DESC (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_DESC structure describes valid values of a property in a particular property configuration.

Syntax

typedef struct _WMDM_PROP_DESC{
  LPWSTR  pwszPropName;
  WMDM_ENUM_PROP_VALID_VALUES_FORM  ValidValuesForm;
  [switch_type(WMDM_ENUM_PROP_VALID_VALUES_FORM)] [switch_is(ValidValuesForm)]  union
  {
    [case (WMDM_ENUM_PROP_VALID_VALUES_ANY)];
  
    [case (WMDM_ENUM_PROP_VALID_VALUES_RANGE)]
        WMDM_PROP_VALUES_RANGE ValidValuesRange;

    [case (WMDM_ENUM_PROP_VALID_VALUES_ENUM)]
        WMDM_PROP_VALUES_ENUM EnumeratedValidValues;
  } ValidValues

} WMDM_PROP_DESC;

Members

pwszPropName

Name of the property. The application must free this memory when it is done using it.

ValidValuesForm

An WMDM_ENUM_PROP_VALID_VALUES_FORM enumeration value describing the type of values, such as a range or list. The value of this enumeration determines which member variable is used.

ValidValues

Holds the valid values of the property in a particular property configuration. This member holds one of three items: the enumeration value WMDM_ENUM_PROP_VALID_VALUES_ANY; the member ValidValuesRange; or the member EnumeratedValidValues. The value or member is indicated by ValidValuesForm.

ValidValuesRange

A WMDM_PROP_VALUES_RANGE structure containing a range of valid values. This is present only when ValidValuesForm is set to WMDM_ENUM_PROP_VALID_VALUES_RANGE. See Remarks.

EnumeratedValidValues

A WMDM_PROP_VALUES_ENUM structure containing an enumerated set of valid values. This is present only when ValidValuesForm is set to WMDM_ENUM_PROP_VALID_VALUES_ENUM. See Remarks.

Remarks

The WMDM_PROP_DESC structure contains a property description that consists of a property name and its valid values in a particular configuration.

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

Requirements

Header: Defined in wmdm.idl.

Library: mssachlp.lib

See Also