IWMDeviceManager2

IWMDeviceManager2 インターフェイスは、IWMDeviceManager インターフェイスを拡張したものです。

GetDeviceFromCanonicalName メソッドは、指定した正規名 (canonical name) を持つデバイスの IWMDMDevice インターフェイスを取得します。デバイスの正規名は、IWMDMDevice2::GetCanonicalName を呼び出して取得できます。

このメソッドは HRESULT を返します。返される値には、次の表に示すものが含まれますが、これらに限定されません。

このメソッドは、アプリケーションが IWMDMNotification を実装している場合に役立ちます。IWMDMNotification は、デバイスがコンピューターに接続または切断されたときに、正規名による通知を送信します。

EnumDevices2 メソッドは、コンピューターに接続されているポータブルデバイスを列挙するために使用する列挙インターフェイスを取得します。

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

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

このメソッドは、プラグアンドプレイ (PnP) システムを利用して、より高速な列挙と少ないメモリ使用量を実現する列挙子を返します。PnP 準拠のサービスプロバイダーについては、現在コンピューターに接続されているデバイスを持つサービスプロバイダーのみをメモリに読み込み、それらのサービスプロバイダーに対してのみデバイスオブジェクトの作成を要求します。

このメソッドは、基になるオブジェクトが最初に作成された時点で接続されていたデバイスのスナップショットを返します。デバイスの一覧を最新の状態にするには、このメソッドを呼び出す前に Reinitialize を呼び出してください。

例

次の C++ のコードは、すべてのデバイスをループ処理し、それぞれの表示名を取得します。

// より高速な EnumDevices2 のプラグアンドプレイ方式を使用してデバイスを列挙します。
// IWMDevMgr2 はグローバルな IWMDeviceManager2 のポインターです。
CComPtr<IWMDMEnumDevice> pEnumDevice;
hr = pIWMDevMgr2->EnumDevices2(&pEnumDevice);
if (hr == S_OK)
{
    // 渡すすべての文字列の長さです。 
    const UINT MAX_CHARS = 100;
    WCHAR name[MAX_CHARS];

    // ダミーのループを使用してデバイスを列挙します。
    while(TRUE)
    {
        // デバイスのハンドルを取得します。
        IWMDMDevice* pDevice;
        ULONG ulFetched = 0;
        hr = pEnumDevice->Next(1, &pDevice, &ulFetched);
        CComQIPtr<IWMDMDevice2> pDevice2(pDevice);

        if (hr != S_OK || ulFetched != 1)
        {
            break;
        }
        ZeroMemory(name, MAX_CHARS);
        hr = pDevice2->GetName(name, MAX_CHARS);
    }
}

Reinitialize メソッドは、Windows Media Device Manager に対して、すべての Windows Media Device Manager デバイスを強制的に再検出させます。

メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT のエラーコードを返します。

Windows Media Device Manager は、プラグアンドプレイ (PnP) の通知を監視して、PnP 準拠のサービスプロバイダーによって制御される接続済みデバイスを追跡します。PnP に準拠していないデバイスが接続された場合や、デバイスが PnP 通知を生成しないような変更 (ストレージカードの挿入や取り外しなど) が行われた場合、アプリケーションは IWMDeviceManager2::EnumDevices2 を呼び出す前に、このメソッドを呼び出す必要があります。通常、アプリケーションはユーザーからの更新要求に応じてこれを行います。