Интерфейс IAudioClient (audioclient.h)

Интерфейс IAudioClient позволяет клиенту создавать и инициализировать аудиопоток между звуковым приложением и обработчиком звука (для потока в общем режиме) или аппаратным буфером устройства конечной точки аудио (для потока в монопольном режиме). Клиент получает ссылку на интерфейс IAudioClient для конечного аудиоустройства, выполнив следующие действия:

1. Используя один из методов, описанных в разделе Интерфейс IMMDevice, получите ссылку на интерфейс IMMDevice для устройства конечной точки звука.
2. Вызовите метод IMMDevice::Activate с параметром iid , равным REFIID IID_IAudioClient.

Поток приложения, использующий этот интерфейс, должен быть инициализирован для COM. Дополнительные сведения об инициализации COM см. в описании функции CoInitializeEx в документации по Windows SDK.

Примеры кода, использующие интерфейс IAudioClient , см. в следующих разделах:

• Отрисовка Stream
• Запись Stream
• Потоки в монопольном режиме

Наследование

Интерфейс IAudioClient наследуется от интерфейса IUnknown . IAudioClient также имеет следующие типы элементов:

Методы

Интерфейс IAudioClient содержит следующие методы.

IAudioClient::GetBufferSize Метод GetBufferSize извлекает размер (максимальную емкость) буфера конечной точки.
IAudioClient::GetCurrentPadding Метод GetCurrentPadding извлекает количество кадров заполнения в буфере конечных точек.
IAudioClient::GetDevicePeriod Метод GetDevicePeriod извлекает длину периодического интервала, разделяющего последовательные проходы обработки звуковым механизмом данных в буфере конечной точки.
IAudioClient::GetMixFormat Метод GetMixFormat извлекает формат потока, используемый обработчиком звука для внутренней обработки потоков общего режима.
IAudioClient::GetService Метод GetService обращается к дополнительным службам из объекта аудиоконферентного клиента.
IAudioClient::GetStreamLatency Метод GetStreamLatency извлекает максимальную задержку для текущего потока и может вызываться в любое время после инициализации потока.
IAudioClient::Initialize Метод Initialize инициализирует аудиопоток.
IAudioClient::IsFormatSupported Метод IsFormatSupported указывает, поддерживает ли устройство конечной точки звука определенный формат потока.
IAudioClient::Reset Метод Reset сбрасывает звуковой поток.
IAudioClient::SetEventHandle Метод SetEventHandle задает дескриптор события, который система сигнализирует, когда звуковой буфер готов к обработке клиентом.
IAudioClient::Start Метод Start запускает аудиопоток.
IAudioClient::Stop Метод Stop останавливает аудиопоток.

Комментарии

Примечание В Windows 8 первое использование IAudioClient для доступа к звуковому устройству должно быть в потоке STA. Вызовы из потока MTA могут привести к неопределенному поведению.

 

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	audioclient.h

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

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

IMMDevice::Activate

WASAPI