WMDM_FORMAT_CAPABILITY结构
WMDM_FORMAT_CAPABILITY结构描述设备针对特定格式的功能。 此结构在 WMDM_PROP_CONFIG 结构数组中包含一组属性配置。 每个属性配置表示一组兼容属性值，这些属性值跨给定格式支持的所有属性。 应用程序可以通过调用 IWMDMDevice3：：GetFormatCapability 方法并传入格式代码来获取此结构。 有关格式代码的列表，请参阅 WMDM_FORMATCODE。
语法
typedef struct _WMDM_FORMAT_CAPABILITY {
UINT nPropConfig;
WMDM_PROP_CONFIG *pConfigs;
} WMDM_FORMAT_CAPABILITY;
成员
-
nPropConfig
-
pConfigs 数组中的属性配置数。
-
pConfigs
-
指向 WMDM_PROP_CONFIG 结构的数组的指针。 数组的大小等于 nPropConfig 的值。
备注
WMDM_FORMAT_CAPABILITY结构提供了一种灵活的机制来表达设备针对特定格式的功能。
例如，如果内容将由设备 (要由设备) 播放的音频文件呈现，则内容的属性必须与 IWMDMDevice3：：GetFormatCapability 在 WMDM_FORMAT_CAPABILITY 结构中返回的属性配置之一匹配。 例如，对于音频文件，比特率和采样率必须满足返回的属性配置之一。
调用方负责释放为此结构分配的内存。 以下函数演示如何清除 WMDM_FORMAT_CAPABILITY 结构。
void FreeFormatCapability(WMDM_FORMAT_CAPABILITY formatCap)
{
// Loop through all configurations.
for (UINT i=0; i < formatCap.nPropConfig; i++)
{
// Loop through all descriptions of a configuration and delete
// the values particular to that description type.
for (UINT j=0; j < formatCap.pConfigs[i].nPropDesc; j++)
{
switch (formatCap.pConfigs[i].pPropDesc[j].ValidValuesForm)
{
case WMDM_ENUM_PROP_VALID_VALUES_ENUM:
for (UINT k=0; k < formatCap.pConfigs[i].pPropDesc[j].ValidValues.EnumeratedValidValues.cEnumValues; k++)
{
PropVariantClear (&(formatCap.pConfigs[i].pPropDesc[j].ValidValues.EnumeratedValidValues.pValues[k]));
}
CoTaskMemFree(formatCap.pConfigs[i].pPropDesc[j].ValidValues.EnumeratedValidValues.pValues);
break;
case WMDM_ENUM_PROP_VALID_VALUES_RANGE:
PropVariantClear (&(formatCap.pConfigs[i].pPropDesc[j].ValidValues.ValidValuesRange.rangeMin));
PropVariantClear (&(formatCap.pConfigs[i].pPropDesc[j].ValidValues.ValidValuesRange.rangeMax));
PropVariantClear (&(formatCap.pConfigs[i].pPropDesc[j].ValidValues.ValidValuesRange.rangeStep));
break;
case WMDM_ENUM_PROP_VALID_VALUES_ANY:
// No dynamically allocated memory for this value.
default:
break;
}
// Free the memory for the description name.
CoTaskMemFree(formatCap.pConfigs[i].pPropDesc[j].pwszPropName);
}
// Free the memory holding the array of description items for this configuration.
CoTaskMemFree(formatCap.pConfigs[i].pPropDesc);
}
// Free the memory pointing to the array of configurations.
CoTaskMemFree(formatCap.pConfigs);
formatCap.nPropConfig = 0;
}
要求
| 要求 | 值 |
|---|---|
| 标头 |
|