WMDM_FORMAT_CAPABILITY

WMDM_FORMAT_CAPABILITY 構造体は、特定の形式に対するデバイスの機能を記述します。この構造体は、WMDM_PROP_CONFIG 構造体の配列としてプロパティ構成の集合を保持します。各プロパティ構成は、指定された形式でサポートされるすべてのプロパティにわたって、互換性のあるプロパティ値の組み合わせを表します。アプリケーションは、IWMDMDevice3::GetFormatCapability メソッドに形式コードを渡して呼び出すことで、この構造体を取得できます。形式コードの一覧については、WMDM_FORMATCODE を参照してください。

WMDM_FORMAT_CAPABILITY 構造体は、特定の形式に対するデバイスの機能を表現するための柔軟な仕組みを提供します。

コンテンツをデバイスで再生することを想定している場合 (たとえば、デバイスで再生されるオーディオ ファイルなど)、そのコンテンツのプロパティは、WMDM_FORMAT_CAPABILITY 構造体として IWMDMDevice3::GetFormatCapability が返すプロパティ構成のいずれかと一致していなければなりません。たとえばオーディオ ファイルの場合、ビット レートとサンプル レートが、返されたプロパティ構成のいずれかを満たす必要があります。

この構造体に割り当てられたメモリを解放するのは呼び出し元の責任です。次の関数は、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;
}