IWMDMDevice2

IWMDMDevice2 インターフェイスは IWMDMDevice を拡張し、デバイスがサポートするビデオ形式の取得、名前によるストレージの検索、およびプロパティ ページの利用を可能にします。

GetStorage メソッドは、ルート ストレージの直下の子から、指定された名前を持つストレージを検索します。

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

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

この関数は再帰的ではありません。デバイスのルート ストレージの直下の子のみを検索します。この関数の再帰検索版が必要な場合は、IWMDMDevice3::FindStorage を使用してください。

例

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

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

    // Start with a quick check of all storages inside the storage.
    // If we found it, stop now and return.
    CComQIPtr<IWMDMStorage2> pStorage2(pCurrentStorage);
    hr = pStorage2->GetStorage(storageName, ppFoundStorage);
    if (*ppFoundStorage != NULL)
        return hr;

    //
    // Otherwise, enumerate through and dive into all child folders.
    //

    // First get enumerator.
    CComPtr<IWMDMEnumStorage> pEnumStorage;
    hr = pCurrentStorage->EnumStorage(&pEnumStorage);
    if (hr != S_OK && pEnumStorage != NULL)
        return hr;

    // Now enumerate all folders until found the right item, or out of folders.
    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;
}

GetFormatSupport2 メソッドは、オーディオおよびビデオのコーデック、MIME ファイル形式を含む、デバイスがサポートする形式を取得します。

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

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

このメソッドは、IWMDMDevice::GetFormatSupport を拡張してビデオ形式を扱えるようにしたものです。ただし、形式のサポート状況を取得する方法として推奨されるのは IWMDMDevice3::GetFormatCapability です。GetFormatCapability がサポートされていない場合、そのデバイスはおそらくビデオをサポートしておらず、GetFormatSupport で十分であると考えられます。

GetSpecifyPropertyPages メソッドは、デバイスのプロパティ ページを取得します。プロパティ ページは、デバイス固有のプロパティやブランド情報を提示するために使用できます。

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

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

GetCanonicalName メソッドは、デバイスの正規名 (canonical name) を取得します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものなどがあります (これらに限定されません)。

アプリケーションは、取得した正規名を使って IWMDeviceManager2::GetDeviceFromCanonicalName を呼び出し、このデバイスを再び見つけることができます。

返される正規名の形式は < PnP Device Path >$< index > であり、index は、指定された PnP デバイス パスに対してサービス プロバイダーが返すデバイス オブジェクトへの 0 を起点とするインデックスです。

正規名の形式は、今後の Windows Media Device Manager のリリースで変更される可能性があります。

例

次の C++ コードは、デバイスの正規名を取得します。

// Obtain an IWMDMDevice2 interface and call
// some methods.
const UINT MAX_CHARS = 100;
CComQIPtr<IWMDMDevice2> pIWMDMDevice2(pIWMDMDevice);
if (pIWMDMDevice2 != NULL)
{
    // Get the canonical name.
    WCHAR canonicalName[MAX_CHARS];
    hr = pIWMDMDevice2->GetCanonicalName(canonicalName, MAX_CHARS);
    if (hr == S_OK)
    {
        // TODO: Retrieve the canonical name.
    }

    // Find out the driver.
    myGetDriverName(pIWMDMDevice2);
}