IWMDMEnumDevice

IWMDMEnumDevice インターフェースは、コンピューターに接続されているポータブルデバイスを列挙します。このインターフェースを取得するには、IWMDeviceManager::EnumDevices を呼び出します。

Next メソッドは、IWMDMDevice インターフェースで表される次のデバイスへのポインターを返します。

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

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

返されるデバイスインターフェースは、キャッシュされたデバイスの一覧に基づいています。プラグアンドプレイデバイスが接続または取り外されても、現在の列挙子にはそれが反映されないため、Next はキャッシュされた一覧に基づいてデバイスを返します。アプリケーションは、IWMDeviceManager::EnumDevices を呼び出して新しい列挙子オブジェクトを取得し、更新されたデバイスの一覧を得る必要があります。

一度に 1 つのインターフェースだけを取得したい場合は、次のコードに示すように、このメソッドのために配列を割り当てる必要はありません。

// 各デバイスを調べるためにデバイス列挙子を取得します。
CComPtr<IWMDeviceManager2> pIWMDevMgr2;
hr = m_IWMDeviceMgr->QueryInterface (__uuidof(IWMDeviceManager2), (void**) &pIWMDevMgr2);
if (hr == S_OK)
{
    // TODO: アプリケーションが IWMDeviceManager2 を取得したことを示すメッセージを表示します。
}
else
{
    // TODO: アプリケーションが EnumDevices で IWMDeviceManager2 を 
    // 取得できなかったことを示すメッセージを表示します。
    return hr;
}

// より高速なプラグアンドプレイ対応の EnumDevices2 メソッドを使用してデバイスを列挙します。
CComPtr<IWMDMEnumDevice> pEnumDevice;
hr = pIWMDevMgr2->EnumDevices2(&pEnumDevice);
if (hr != S_OK)
{
    //.TODO: EnumDevices2 の呼び出しでエラーが発生したことを示すメッセージを表示します。
    return hr;
}

// デバイスを列挙します。
IWMDMDevice *pIWMDMDevice;
ULONG ulFetched = 0;
while(pEnumDevice->Next(1, &pIWMDMDevice, &ulFetched) == S_OK)
{
    if (ulFetched != 1)
    {
        return E_FAIL;
    }
    // ここで何らかの処理を行います....
}

Skip メソッドは、列挙シーケンス内の指定された数のデバイスをスキップします。

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

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

スキップを要求したデバイスの数が残りのデバイス数より多い場合、Skip の戻り値は S_FALSE になります。この場合、スキップされたインターフェースの数を判断するには pceltFetched を使用する必要があります。デバイス配列の末尾までスキップした場合、その後の Next の呼び出しも S_FALSE を返します。標準の列挙子の Skip メソッドの詳細については、Microsoft の Web サイトで入手できる Microsoft COM のドキュメントを参照してください。

Reset メソッドは列挙をリセットし、Next が最初のデバイスへのポインターを返すようにします。

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

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

Clone メソッドは、IWMDMEnumDevice インターフェースのコピーを返します。新しい列挙子は、現在の列挙子と同じ列挙状態を指定します。

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

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

このメソッドを使用すると、クライアントは列挙シーケンス内の特定の位置を記録し、後でその位置に戻ることができます。新しい列挙子は、元の列挙子と同じインターフェースをサポートします。