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

В этом справочнике по программированию для пакета SDK для core Audio SDK содержатся следующие интерфейсы:

MMDevice API

API мультимедийного устройства Windows (MMDevice) позволяет аудио-клиентам обнаруживать устройства конечной точки звука, определять их возможности и создавать экземпляры драйверов для этих устройств. Файл заголовка Mmdeviceapi.h определяет интерфейсы в API MMDevice. Дополнительные сведения см. в разделе о API MMDevice.

В следующей таблице перечислены интерфейсы MMDevice, доступные с помощью основного пакета SDK для аудио для Windows Vista.

Интерфейс	Description
IMMDevice	Представляет звуковое устройство.
IMMDeviceCollection	Представляет коллекцию звуковых устройств.
IMMDeviceEnumerator	Предоставляет методы перечисления звуковых устройств.
IMMEndpoint	Представляет устройство конечной точки аудио.
IMMNotificationClient	Предоставляет уведомления о добавлении или удалении устройства аудио конечной точки при изменении состояния или свойств устройства или при изменении роли по умолчанию, назначенной устройству.

WASAPI

API сеанса аудио Windows (WASAPI) позволяет клиентским приложениям управлять потоком звуковых данных между приложением и устройством аудио конечной точки. Файлы заголовков Audioclient.h и Audiopolicy.h определяют интерфейсы WASAPI. Дополнительные сведения см. в разделе "О WASAPI".

В следующей таблице перечислены интерфейсы WASAPI, доступные с помощью основного пакета SDK для аудио для Windows Vista и более поздних версий.

Интерфейс	Description
IActivateAudioInterfaceAsyncOperation	Представляет асинхронную операцию активации интерфейса WASAPI и предоставляет метод для получения результатов активации. Применяется начиная с Windows 8.
IActivateAudioInterfaceCompletionHandler	Предоставляет обратный вызов, указывающий, что активация интерфейса WASAPI завершена. Применяется начиная с Windows 8.
IAudioCaptureClient	Позволяет клиенту считывать входные данные из буфера конечной точки записи.
IAudioClient	Позволяет клиенту создавать и инициализировать аудиопоток между звуковым приложением и подсистемой аудио или аппаратным буфером устройства аудио конечной точки.
IAudioClock	Позволяет клиенту отслеживать скорость данных потока и текущую позицию в потоке.
IAudioClock2	Позволяет клиенту получить текущее положение устройства.
IAudioClockAdjustment	Позволяет клиенту задать частоту выборки потока.
IAudioRenderClient	Позволяет клиенту записывать выходные данные в буфер конечной точки отрисовки.
IAudioSessionControl	Позволяет клиенту настраивать параметры управления для звукового сеанса и отслеживать события в сеансе.
IAudioSessionControl2	Позволяет клиенту получать сведения о звуковом сеансе.
IAudioSessionManager	Позволяет клиенту получать доступ к элементам управления сеансом и элементам управления громкости для сеансов между процессами и процессами.
IAudioSessionManager2	Управляет всеми подмиксами, включая перечисление и уведомление подмиксов. Она также обеспечивает поддержку утихих уведомлений.
IAudioSessionEnumerator	Позволяет клиенту перечислять звуковые сеансы.
IAudioStreamVolume	Позволяет клиенту контролировать и отслеживать уровни громкости для всех каналов в звуковом потоке.
IChannelAudioVolume	Позволяет клиенту управлять уровнями томов для всех каналов в звуковом сеансе, к которому принадлежит поток.
ISimpleAudioVolume	Позволяет клиенту управлять уровнем основного тома сеанса звука.
IAudioSessionEvents	Предоставляет уведомления о событиях, связанных с сеансом, таких как изменения уровня тома, отображаемое имя и состояние сеанса.
IAudioSessionNotification	Отправляет уведомления при изменении сеанса.
IAudioVolumeDuckNotification	Отправляет уведомления о ожидающих изменениях в системе.

DeviceTopology API

API DeviceTopology предоставляет клиентские приложения с возможностью обхода функциональных аппаратных топологий устройств отрисовки и записи звука. Файл заголовка Devicetopology.h определяет интерфейсы в API DeviceTopology. Дополнительные сведения см. в разделе "Топологии устройств" и API DeviceTopology.

В следующей таблице перечислены интерфейсы DeviceTopology, доступные с помощью основного пакета SDK для аудио для Windows Vista и более поздних версий.

Интерфейс	Description
IAudioAutoGainControl	Предоставляет доступ к аппаратному автоматическому управлению получением (AGC).
IAudioBass	Предоставляет доступ к аппаратному элементу управления басового уровня.
IAudioChannelConfig	Предоставляет доступ к элементу управления конфигурации канала оборудования.
IAudioInputSelector	Предоставляет доступ к аппаратному элементу управления мультиплексором (селектор ввода).
IAudioLoudness	Предоставляет доступ к контролю за "громкость" компенсации.
IAudioMidrange	Предоставляет доступ к аппаратному элементу управления среднего уровня.
IAudioMute	Предоставляет доступ к аппаратному элементу управления выключения.
IAudioOutputSelector	Предоставляет доступ к аппаратному элементу управления demultiplexer (селектор вывода).
IAudioPeakMeter	Предоставляет доступ к аппаратному элементу управления пикового измерения.
IAudioTreble	Предоставляет доступ к аппаратному элементу управления с трепетным уровнем.
IAudioVolumeLevel	Предоставляет доступ к аппаратному элементу управления томами.
I Подключение or	Представляет точку соединения между компонентами.
IControlInterface	Представляет интерфейс элемента управления (подъединений или соединителя).
IDeviceSpecificProperty	Представляет свойство для конкретного устройства соединителя или подъединения.
IDeviceTopology	Предоставляет доступ к топологии звукового устройства.
IKsFormatSupport	Предоставляет сведения о форматах аудиоданных, поддерживаемых программным подключением ввода-вывода (обычно канал DMA) между звуковым устройством и системной памятью.
IKsJackDescription	Предоставляет сведения о разъемах или внутренних соединителях, которые обеспечивают физическое подключение между устройством на звуковом адаптере и внешнем или внутреннем устройстве конечной точки (например, микрофоном или проигрывателем компакт-дисков).
IKsJackDescription2	Предоставляет удобный доступ к свойству KSPROPERTY_JACK_DESCRIPTION2 соединителя к устройству конечной точки.
IKsJackSinkInformation	Предоставляет сведения о приемнике джека, если разъем поддерживается оборудованием.
Параметрической детали	Представляет часть (соединитель или подсеть) топологии устройства.
IPartsList	Представляет список частей (соединителей и вложенных элементов).
IPerChannelDbLevel	Представляет универсальный интерфейс управления подсоединения, обеспечивающий управление на уровне громкости в децибелях аудиопотока или полосы частоты в звуковом потоке.
ISubunit	Представляет аппаратный подсоединение (например, элемент управления уровня тома), который находится в пути к данным между клиентом и устройством аудио конечной точки.
IControlChangeNotify	Предоставляет уведомления при изменении состояния части (соединителя или подъединения).

EndpointVolume API

API EndpointVolume позволяет специализированным клиентам контролировать и отслеживать уровни громкости устройств аудиоконечной точки. Файл заголовка Endpointvolume.h определяет интерфейсы в API EndpointVolume. Дополнительные сведения см. в разделе API EndpointVolume.

В следующей таблице перечислены интерфейсы EndpointVolume, доступные с помощью основного пакета SDK для аудио для Windows Vista.

Интерфейс	Description
IAudioEndpointVolume	Представляет элементы управления громкостями в звуковом потоке или с устройства конечной точки аудио.
IAudioEndpointVolumeEx	Предоставляет элементы управления громкости в аудиопотоке или из конечной точки устройства.
IAudioMeterInformation	Представляет пиковый метр на аудиопотоке или с устройства аудио конечной точки.
IAudioEndpointVolumeCallback	Предоставляет уведомления о том, когда изменяется уровень громкости или отключение состояния устройства звуковой конечной точки.

См. также

Справочник по программированию