Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Указывает характеристики, которые клиент может назначать аудиопотоку во время инициализации потока.
| Константа/значение | Description |
|---|---|
|
Аудиопоток будет членом межпроцессного звукового сеанса. Дополнительные сведения см. в разделе "Примечания". |
|
Звуковой поток будет работать в режиме обратного цикла. Дополнительные сведения см. в разделе "Примечания". |
|
Обработка звукового буфера клиентом будет управляться событием. Дополнительные сведения см. в разделе "Примечания". |
|
Параметры громкости и отключения звука для звукового сеанса не будут сохраняться во время перезапуска приложения. Дополнительные сведения см. в разделе "Примечания". |
|
Эта константа новая в Windows 7. Частота выборки потока корректируется на частоту, указанную приложением. Дополнительные сведения см. в разделе "Примечания". |
|
Матрица каналов и преобразователь частоты выборки вставляются при необходимости для преобразования между несжатым форматом, предоставленным в IAudioClient::Initialize и форматом смешивания звукового модуля. |
|
При использовании с AUDCLNT_STREAMFLAGS_AUTOCONVERTPCM используется преобразователь скорости выборки с более высоким качеством, чем преобразование по умолчанию, но с более высокой производительностью используется. Это следует использовать, если звук в конечном счете предназначен для прослушивания людьми, в отличие от других сценариев, таких как насос молчание или заполнение счетчика. |
Замечания
Метод IAudioClient::Initialize и структура DIRECTX_AUDIO_ACTIVATION_PARAMS используют константы AUDCLNT_STREAMFLAGS_XXX .
Флаг AUDCLNT_STREAMFLAGS_CROSSPROCESS указывает, что звуковой сеанс для потока является межпроцессным сеансом. Межпроцессный сеанс может принимать потоки из нескольких процессов. Если два приложения в двух отдельных процессах вызывают IAudioClient::Initialize с идентичными идентификаторами GUID сеанса, а оба приложения задают флаг AUDCLNT_SHAREMODE_CROSSPROCESS, то звуковой механизм назначает потоки одному и тому же межпроцессному сеансу. Этот флаг переопределяет поведение по умолчанию, которое заключается в назначении потока сеансу для конкретного процесса, а не межпроцессному сеансу. Бит флага AUDCLNT_STREAMFLAGS_CROSSPROCESS несовместим с эксклюзивным режимом. Дополнительные сведения о межпроцессных сеансах см. в разделе "Сеансы аудио".
Флаг AUDCLNT_STREAMFLAGS_LOOPBACK включает запись обратного цикла. При записи обратной передачи звуковой модуль копирует аудиопоток, который воспроизводится устройством конечной точки отрисовки в буфер конечной точки звука, чтобы клиент WASAPI смог записать поток. Если этот флаг задан, метод IAudioClient::Initialize пытается открыть буфер записи на устройстве отрисовки. Этот флаг действителен только для устройства отрисовки, и только если вызов Initialize задает параметр ShareMode AUDCLNT_SHAREMODE_SHARED. В противном случае вызов инициализации завершится ошибкой. При успешном вызове клиент может вызвать метод IAudioClient::GetService для получения интерфейса IAudioCaptureClient на устройстве отрисовки. Дополнительные сведения см. в разделе "Запись обратного цикла".
Флаг AUDCLNT_STREAMFLAGS_EVENTCALLBACK включает буферизацию на основе событий. Если клиент задает этот флаг в вызове IAudioClient::Initialize , который инициализирует поток, клиент должен впоследствии вызвать метод IAudioClient::SetEventHandle , чтобы предоставить дескриптор событий для потока. После запуска потока звуковой модуль сигнализирует обработчику событий уведомлять клиента каждый раз, когда буфер будет готов для обработки клиента. WASAPI поддерживает буфер на основе событий для буферов отрисовки и записи. Потоки общего режима и монопольного режима могут использовать буферизацию на основе событий. Пример кода, использующий флаг AUDCLNT_STREAMFLAGS_EVENTCALLBACK, см. в разделе Exclusive-Mode Streams.
Флаг AUDCLNT_STREAMFLAGS_NOPERSIST отключает сохраняемость тома и отключение параметров сеанса, содержащего потоки отрисовки. По умолчанию уровень тома и состояние отключения сеанса отрисовки сохраняются во время перезапуска приложения. Уровень тома и состояние отключения для сеанса записи никогда не сохраняются. Дополнительные сведения о сохраняемости тома сеанса и отключении параметров см. в разделе "Сеансы аудио".
Флаг AUDCLNT_STREAMFLAGS_RATEADJUST позволяет приложению получить ссылку на интерфейс IAudioClockAdjustment , используемый для задания частоты выборки для потока. Чтобы получить указатель на этот интерфейс, приложение должно инициализировать звуковой клиент с помощью этого флага, а затем вызвать IAudioClient::GetService , указав идентификатор IID_IAudioClockAdjustment . Чтобы задать новую частоту выборки, вызовите IAudioClockAdjustment::SetSampleRate. Этот флаг действителен только для устройства отрисовки. В противном случае вызов GetService завершается сбоем с кодом ошибки AUDCLNT_E_WRONG_ENDPOINT_TYPE. Приложение также должно задать параметр ShareMode для AUDCLNT_SHAREMODE_SHARED во время вызова Initialize . SetSampleRate завершается ошибкой, если звуковой клиент не находится в общем режиме.
Требования
| Требование | Ценность |
|---|---|
| Минимальная версия клиента |
Windows Vista [классические приложения | Приложения UWP] |
| Минимально поддерживаемый сервер |
Windows Server 2008 [классические приложения | Приложения UWP] |
| Header |
|