IWMDMStorage2

IWMDMStorage2 インターフェースは IWMDMStorage を拡張し、名前を指定して子ストレージを取得したり、拡張属性を取得・設定したりできるようにします。IWMDMStorage3 インターフェースは、メタデータをサポートすることでこのインターフェースを拡張します。

GetStorage メソッドは、すべての子を列挙することなく、現在のストレージから名前を指定して子ストレージを直接取得します。

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

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

IWMDMStorage2::GetStorage はワイルドカード文字をサポートしません。また再帰的でもありません。つまり、現在のストレージの直下の子であるストレージしか見つけられません。2 階層以上深いストレージを検索するには、IWMDMDevice3::FindStorage を使用してください。

例

次の C++ 関数は、ストレージを再帰的に検索します。まず GetStorage で直下の子を検索し、目的のストレージが見つからない場合は、すべての子をループしてフォルダーを再帰的に検索します。

HRESULT myFindStorageRecursively(LPCWSTR storageName, IWMDMStorage* pCurrentStorage, IWMDMStorage** ppFoundStorage)
{
    HRESULT hr = S_OK;

    // まず、ストレージ内のすべてのストレージを手早く確認する。
    // 見つかったら、ここで終了して戻る。
    CComQIPtr<IWMDMStorage2> pStorage2(pCurrentStorage);
    hr = pStorage2->GetStorage(storageName, ppFoundStorage);
    if (*ppFoundStorage != NULL)
        return hr;

    //
    // 見つからなければ、すべての子フォルダーを列挙して掘り下げる。
    //

    // 最初に列挙子を取得する。
    CComPtr<IWMDMEnumStorage> pEnumStorage;
    hr = pCurrentStorage->EnumStorage(&pEnumStorage);
    if (hr != S_OK && pEnumStorage != NULL)
        return hr;

    // 目的の項目が見つかるか、フォルダーがなくなるまですべてのフォルダーを列挙する。
    CComPtr<IWMDMStorage> pThisStorage;
    DWORD numRetrieved = 0;
    DWORD attr = 0;
    while(pEnumStorage->Next(1, &pThisStorage, &numRetrieved) == S_OK)
    {
        pThisStorage->GetAttributes(&attr, NULL);
        if (attr & WMDM_FILE_ATTR_FOLDER)
        {
            hr = myFindStorageRecursively(storageName, pThisStorage, ppFoundStorage);
            if (*ppFoundStorage != NULL)
                return hr;
        }
        pThisStorage.Release();
    }

    return hr;
}

SetAttributes2 メソッドは、ストレージの拡張属性を設定します。

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

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

GetAttributes2 メソッドは、ストレージの拡張属性を取得します。

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

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

属性の評価は、メディアデバイスの内容を公開する際の重要な手順です。デバイスによっては、記憶メディア上でのデータの階層的な格納をサポートしていない場合があります。GetAttributes2 メソッドは、オブジェクトの属性を通じてファイルシステムの構造を調べることで、そのサポート状況と形式を推測するために使用します。