Интерфейс 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

См. также раздел

Основные звуковые интерфейсы

Интерфейс IMMDevice

Интерфейс IMMDeviceCollection

IMMDeviceCollection::Item

IMMDeviceEnumerator::EnumAudioEndpoints

MMDevice API