IWMDeviceManager2::EnumDevices2 メソッド (mswmdm.h)

[アーティクル]
03/05/2024

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

Microsoft では、アプリケーションで IWMDeviceManager::EnumDevices の代わりに EnumDevices2 メソッドを使用することを強くお勧めします。

構文

HRESULT EnumDevices2(
  [out] IWMDMEnumDevice **ppEnumDevice
);

パラメーター

[out] ppEnumDevice

IWMDMEnumDevice インターフェイスへのポインターへのポインター。呼び出し元は、取得したインターフェイスで Release を呼び出す役割を担います。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

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

このメソッドは、基になるオブジェクトが最初に作成されたときに接続されているデバイスのスナップショットを返します。デバイスリストが最新であることを確認するには、このメソッドを呼び出す前に Reinitialize を呼び出します。

例

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


// Enumerate through the devices using the faster EnumDevices2 Plug-and-Play method.
// IWMDevMgr2 is a global IWMDeviceManager2 pointer.
CComPtr<IWMDMEnumDevice> pEnumDevice;
hr = pIWMDevMgr2->EnumDevices2(&pEnumDevice);
if (hr == S_OK)
{
    // Length of all the strings we'll send in. 
    const UINT MAX_CHARS = 100;
    WCHAR name[MAX_CHARS];

    // Enumerate through devices using a dummy loop.
    while(TRUE)
    {
        // Get a device handle.
        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);
    }
}