다음을 통해 공유

Windows Media Device Manager 장치 열거하기

  • 아티클

애플리케이션을 인증한 후 Windows Media Device Manager에서 검색한 디바이스를 열거하기 시작할 수 있습니다. 열거는 IWMDeviceManager2::EnumDevices2 또는 IWMDeviceManager::EnumDevices를 사용하여 얻은 IWMDMEnumDevice열거 인터페이스를 사용하여 수행됩니다. 지원되는 경우 이전 버전이 디바이스에서 레거시 인터페이스만 반환하는 반면 새 버전은 레거시 인터페이스와 새 인터페이스를 모두 반환하므로 EnumDevices2 메서드를 사용합니다.

열거자를 가져오기 전에 사용할 열거형 뷰를 결정해야 합니다. 일부 디바이스는 각 스토리지를 다른 디바이스로 노출합니다. 예를 들어 디바이스의 플래시 메모리 카드 2개는 별도의 디바이스인 것처럼 열거됩니다. 디바이스의 모든 스토리지가 단일 디바이스로 함께 열거되도록 지정할 수 있습니다. 이 기본 설정은 애플리케이션에서 한 번만 설정할 수 있습니다. 변경하려면 애플리케이션을 종료하고 다시 시작해야 합니다. 그러나 레거시 디바이스는 때때로 별도의 디바이스 스토리지를 단일 디바이스로 열거하라는 요청을 무시하고 별도로 열거하는 것을 계속합니다.

다음 단계에서는 연결된 디바이스를 열거하는 방법을 보여줍니다.

  1. IWMDeviceManager3::SetDeviceEnumPreference사용하여 디바이스 열거형 기본 설정을 지정합니다. 이 메서드를 호출하지 않으면 기본 방법은 스토리지를 별도의 디바이스로 표시하는 것입니다. 개별 "디바이스"가 실제로 동일한 디바이스의 스토리지인지 여부를 확인하려면 IWMDMDevice2::GetCanonicalName; 동일한 디바이스의 스토리지는 마지막 "$" 기호 뒤의 최종 숫자를 제외하고 동일한 값을 반환합니다.
  2. IWMDeviceManager 또는 IWMDeviceManager2쿼리한 다음 IWMDeviceManager2::EnumDevices2 호출하여 IWMDMEnumDevice디바이스 열거자 인터페이스를 가져옵니다. (지원되는 경우 이전 버전이 MTP 디바이스를 반환하지 않을 수 있으므로 더 효율적인 EnumDevices2사용합니다.)
  3. IWMDMEnumDevices::Next 메서드를 호출하여 한 번에 하나 이상의 디바이스를 검색합니다. 메서드가 S_FALSE 또는 오류 메시지를 반환할 때까지 이 메서드를 계속 호출합니다. 한 번에 하나의 디바이스만 검색하는 경우 디바이스를 저장할 배열을 할당할 필요가 없습니다.

애플리케이션이 실행되는 동안 사용자가 컴퓨터에서 디바이스를 연결하거나 제거할 수 있으므로 디바이스 연결 또는 제거 알림을 구현하는 것이 좋습니다. 이 작업은 IWMDMNotification 인터페이스를 구현하고 등록하여 수행됩니다. 이에 대한 자세한 내용은 알림 활성화을 참조하세요.

다음 C++ 코드는 디바이스를 열거하고 각 디바이스에 대한 정보를 요청합니다.

HRESULT CWMDMController::EnumDevices()
{
    HRESULT hr = S_OK;

    // Change behavior to show devices as one object, not each storage as a device.
    // This can be called only once for each instance of this application.
    CComQIPtr<IWMDeviceManager3>pDevMgr3(m_IWMDMDeviceMgr);
    hr = pDevMgr3->SetDeviceEnumPreference(DO_NOT_VIRTUALIZE_STORAGES_AS_DEVICES);
    
    // Get number of attached devices.
    DWORD iDevices = 0;
    hr = m_IWMDMDeviceMgr->GetDeviceCount(&iDevices);
    if (hr == S_OK)
    {
        // TODO: Display count of devices.
    }

    //
    // Get a device enumerator to enumerate devices.
    //
    CComPtr<IWMDeviceManager2> pDevMgr2;
    hr = m_IWMDMDeviceMgr->QueryInterface (__uuidof(IWMDeviceManager2), (void**) &pDevMgr2);
    if (hr == S_OK)
    {
        // TODO: Display message indicating that application obtained IWMDeviceManager2.
    }
    else
    {
        // TODO: Display message indicating that we couldn't 
        // get IWMDeviceManager2 in EnumDevices.
        return hr;
    }
   CComPtr<IWMDMEnumDevice> pEnumDevice;
   hr = pDevMgr2->EnumDevices2(&pEnumDevice);
    if (hr != S_OK)
    {
        // TODO: Display messaging indicating that an error occurred 
        // in calling EnumDevices2.
        return hr;
    }

    // Length of all the strings we'll send in. 
    const UINT MAX_CHARS = 100;

    // Iterate through devices.
    while(TRUE)
    {
        // Get a device handle.
        IWMDMDevice *pIWMDMDevice;
        ULONG ulFetched = 0;
        hr = pEnumDevice->Next(1, &pIWMDMDevice, &ulFetched);
        if ((hr != S_OK) || (ulFetched != 1))
        {
            break;
        }
        
        // Get a display icon for the device.
        ULONG deviceIcon = 0;
        hr = pIWMDMDevice->GetDeviceIcon(&deviceIcon);

        // Print the device manufacturer.
        WCHAR manufacturer[MAX_CHARS];
        hr = pIWMDMDevice->GetManufacturer((LPWSTR)&manufacturer, MAX_CHARS);
        if (hr == S_OK)
        {
            // TODO: Display manufacturer name.
        }

        // Get the device name.
        WCHAR name[MAX_CHARS];
        hr = pIWMDMDevice->GetName((LPWSTR)&name, MAX_CHARS);
        if (hr == S_OK)
        {
            // TODO: Display name.
        }

        // TODO: Get other device information if wanted.

        // Obtain an IWMDMDevice2 interface and call some methods.
        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: Display canonical name.
            }
        }

        // Obtain an IWMDMDevice3 interface and call some methods.
        CComQIPtr<IWMDMDevice3>pIWMDMDevice3(pIWMDMDevice);
        if (pIWMDMDevice3 != NULL)
        {
            // Find out what protocol is being used.
            PROPVARIANT val;
            PropVariantInit(&val);
            hr = pIWMDMDevice3->GetProperty(g_wszWMDMDeviceProtocol, &val);

            if (hr == S_OK)
            {
                if (*val.puuid == WMDM_DEVICE_PROTOCOL_RAPI)
                {
                    // TODO: Display message indicating device is a RAPI device.
                }
                else if (*val.puuid == WMDM_DEVICE_PROTOCOL_MTP)
                {
                    / /TODO: Display message indicating device is an MTP device.
                }
                else if (*val.puuid == WMDM_DEVICE_PROTOCOL_MSC)
                {
                    // TODO: Display message indicating device is an MSC device.
                }
                else
                {
                    // TODO: Display message indicating that the 
                    // application encountered an unknown protocol.
                }
                PropVariantClear(&val);
            }
        }

        // Examine the device capabilities. You could use some of these
        // to enable or disable the application's UI elements.
        CComQIPtr<IWMDMDeviceControl> pDeviceControl(pIWMDMDevice);
        if (pDeviceControl != NULL)
        {
            DWORD caps = 0;
            hr = pDeviceControl->GetCapabilities(&caps);
            if (caps & WMDM_DEVICECAP_CANPLAY)
            {
                // TODO: Display message indicating that the media 
                // device can play MP3 audio.
            }
            // TODO: Test for other capabilities here.
        }
    } // Get the next device.
    return hr;
}

Windows Media Device Manager 애플리케이션 만들기