Перечисление устройств Диспетчера устройств Windows Media
После проверки подлинности приложения можно начать перечисление устройств, обнаруженных диспетчером устройств Windows Media. Перечисление выполняется с помощью интерфейса перечисления IWMDMEnumDevice, полученного с помощью IWMDeviceManager2::EnumDevices2 или IWMDeviceManager::EnumDevices. При поддержке используйте метод EnumDevices2, так как более ранняя версия возвращала только устаревшие интерфейсы на устройствах, а новая версия возвращает как устаревшие, так и новые интерфейсы.
Перед получением перечислителя необходимо решить, какое представление перечисления следует использовать. Некоторые устройства отображают каждое хранилище как отдельное устройство. Например, две карты памяти флэш-памяти на устройстве будут перечисляться так, как если бы они были отдельными устройствами. Вы можете указать, что все хранилища на устройстве перечисляются вместе как одно устройство. Этот параметр можно задать только один раз в приложении; Если вы хотите изменить его, необходимо завершить работу приложения и перезапустить его. Однако обратите внимание, что устаревшие устройства иногда игнорируют запрос на перечисление отдельных хранилищ устройств в качестве одного устройства и продолжают перечислять их отдельно.
Ниже показано, как перечислить подключенные устройства:
- Задайте параметр перечисления устройств с помощью IWMDeviceManager3::SetDeviceEnumPreference. Если этот метод не вызывается, то по умолчанию используется способ отображения хранилищ в виде отдельных устройств. Чтобы определить, являются ли отдельные устройства фактически хранилищами на одном устройстве, вызовите IWMDMDevice2::GetCanonicalName; хранилища с того же устройства возвращают идентичные значения, за исключением последней цифры после последнего знака "$".
- Запрос IWMDeviceManager или IWMDeviceManager2, а затем вызовите IWMDeviceManager2::EnumDevices2, чтобы получить интерфейс перечислителя устройств, IWMDMEnumDevice. (При поддержке используйте EnumDevices2, что более эффективно, так как более ранняя версия не может возвращать устройства MTP).
- Вызовите метод 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;
}
Связанные разделы