Интерфейс IMMDeviceEnumerator (mmdeviceapi.h)
Интерфейс IMMDeviceEnumerator предоставляет методы для перечисления ресурсов мультимедийных устройств. В текущей реализации API MMDevice единственными ресурсами устройств, которые может перечислить этот интерфейс, являются звуковые конечные устройства. Клиент получает ссылку на интерфейс IMMDeviceEnumerator , вызывая функцию CoCreateInstance , как описано выше (см. API MMDevice).
Ресурсы устройства, перечисляемые методами в интерфейсе IMMDeviceEnumerator , представлены в виде коллекций объектов с интерфейсами IMMDevice . Коллекция имеет интерфейс IMMDeviceCollection . Метод IMMDeviceEnumerator::EnumAudioEndpoints создает коллекцию устройств.
Чтобы получить указатель на интерфейс IMMDevice элемента в коллекции устройств, клиент вызывает метод IMMDeviceCollection::Item .
Примеры кода, использующие интерфейс IMMDeviceEnumerator , см. в следующих разделах:
Наследование
Интерфейс IMMDeviceEnumerator наследуется от интерфейса IUnknown . IMMDeviceEnumerator также имеет следующие типы членов:
Методы
Интерфейс IMMDeviceEnumerator содержит следующие методы.
| IMMDeviceEnumerator::EnumAudioEndpoints Метод EnumAudioEndpoints создает коллекцию звуковых конечных устройств, соответствующих указанным критериям. |
| IMMDeviceEnumerator::GetDefaultAudioEndpoint Метод GetDefaultAudioEndpoint извлекает конечную точку звука по умолчанию для указанного направления и роли потока данных. |
| IMMDeviceEnumerator::GetDevice Метод GetDevice извлекает устройство конечной точки звука, идентифицируемое строкой идентификатора конечной точки. |
| IMMDeviceEnumerator::RegisterEndpointNotificationCallback Метод RegisterEndpointNotificationCallback регистрирует интерфейс обратного вызова уведомления клиента. |
| IMMDeviceEnumerator::UnregisterEndpointNotificationCallback Метод UnregisterEndpointNotificationCallback удаляет регистрацию интерфейса уведомлений, зарегистрированного клиентом в предыдущем вызове метода IMMDeviceEnumerator::RegisterEndpointNotificationCallback. |
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | mmdeviceapi.h |