IWMDMMetaData

IWMDMMetaData インターフェイスは、ストレージのメタデータ プロパティ (アーティスト、アルバム、ジャンルなど) を設定および取得します。

AddItem メソッドは、メタデータ プロパティをインターフェイスに追加します。

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェイス メソッドは、次の種類のエラー コードを返す可能性があります。

• 標準の COM エラー コード
• HRESULT 値に変換された Windows エラー コード
• Windows Media Device Manager のエラー コード

QueryByName メソッドは、名前で指定されたプロパティの値を取得します。

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェイス メソッドは、次の種類のエラー コードを返す可能性があります。

• 標準の COM エラー コード
• HRESULT 値に変換された Windows エラー コード
• Windows Media Device Manager のエラー コード

QueryByIndex メソッドは、インデックスで指定されたプロパティの値を取得します。

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェイス メソッドは、次の種類のエラー コードを返す可能性があります。

• 標準の COM エラー コード
• HRESULT 値に変換された Windows エラー コード
• Windows Media Device Manager のエラー コード

GetItemCount メソッドは、インターフェイスが保持しているプロパティの総数を取得します。

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェイス メソッドは、次の種類のエラー コードを返す可能性があります。

• 標準の COM エラー コード
• HRESULT 値に変換された Windows エラー コード
• Windows Media Device Manager のエラー コード

このメソッドは、QueryByIndex と組み合わせて、ストレージまたはデバイス上のすべてのプロパティを列挙するために使用できます。

例

次のコードは、IWMDMMetaData インターフェイス (pMetadata) に含まれるプロパティの数を取得し、それらをすべてインデックスで取得して表示しようとします。カスタムのエラー処理マクロ BREAK_HR を使用しています。

        //
        // すべてのメタデータ プロパティをループ処理し、それぞれの値を表示します。
        //
        BYTE* value;
        WMDM_TAG_DATATYPE type;
        UINT len = 0;
        UINT count = 0;
        WCHAR* name;
        // メタデータ項目の数を取得します。
        hr = pMetadata->GetItemCount(&count);

        BREAK_HR(hr, "GetMetadata でメタデータの数を取得しました。", "GetMetadata でメタデータの数を取得できませんでした。");
        for(;count > 0; count--)
        {
            // メタデータ プロパティをインデックスで取得します。
            WCHAR* name;
            hr = pMetadata->QueryByIndex(count-1, &name, &type, &value, &len);
            if (SUCCEEDED(hr))
            {
                // TODO: プロパティ名を表示します。
                CoTaskMemFree(name);

                // 値の型に応じて、プロパティの値を表示します。
                switch (type)
                {
                case WMDM_TYPE_QWORD:
                case WMDM_TYPE_DWORD:
                case WMDM_TYPE_WORD:
                    // TODO: 値を表示します。
                    break;
                case WMDM_TYPE_STRING:
                    // TODO: 値を表示します。
                    // メソッドが割り当てたプロパティ値のメモリを解放します。
                    if (SUCCEEDED(hr))
                        CoTaskMemFree(value);
                    break;
                case WMDM_TYPE_BOOL:
                    // TODO: 値を表示します。
                    break;
                case WMDM_TYPE_BINARY:
                    // TODO: 値を表示します。
                    break;
                case WMDM_TYPE_DATE:
                    {
                        WMDMDATETIME *val = (WMDMDATETIME*)value;
                        / /TODO: 月、日、年を表示します。
                    }
                    break;
                case WMDM_TYPE_GUID:
                    {
                        WCHAR strGuid[64];
                        StringFromGUID2(reinterpret_cast<GUID&>(value),(LPOLESTR)strGuid, 64);
                        / /TODO: GUID を表示します。
                    }
                    break;
                default:
                    // TODO: 返された値の型をアプリケーションが解釈できなかったことを
                    // 示すメッセージを表示します。
                }
            }
            else // インデックス count - 1 のメタデータ プロパティを取得できませんでした。
                // TODO: そのインデックスの値をアプリケーションが取得できなかったことを
                // 示すメッセージを表示します。
        // WMDM が割り当てたメモリをクリアします。
        if (value)
            CoTaskMemFree(value);
        }