Поделиться через


PKEY_AudioEndpoint_FullRangeSpeakers

Свойство PKEY_AudioEndpoint_FullRangeSpeakers указывает маску конфигурации канала для полного диапазона динамиков, подключенных к устройству конечной точки аудио. Маска указывает физическую конфигурацию полного диапазона динамиков и указывает назначение каналов для этих динамиков.

Элемент vt структуры PROPVARIANT имеет значение VT_UI4.

Элемент uintVal структуры PROPVARIANT содержит маску конфигурации канала, приведенную к типу UINT.

Полноразмерный динамик способен воспроизводить звуки в полном диапазоне от баса до трибла. Как правило, большие динамики имеют полный диапазон, но меньшие динамики значительно менее способны воспроизводить басовые звуки. В Windows Vista обработчик звука использует это свойство для управления уровнями баса в потоке вывода звука, воспроизводимом устройством конечной точки звука.

Маска конфигурации канала для этого свойства имеет тот же формат, что и маска конфигурации канала для свойства PKEY_AudioEndpoint_PhysicalSpeakers . Дополнительные сведения о масках конфигурации каналов см. в разделе KSPROPERTY_AUDIO_CHANNEL_CONFIG.

Система получает маску конфигурации канала для свойства PKEY_AudioEndpoint_FullRangeSpeakers от пользователя. Пользователь вводит эти сведения через панель управления мультимедиа Windows, Mmsys.cpl. Дополнительные сведения о Mmsys.cpl см. в документации по Windows DDK.

Маска конфигурации канала для свойства PKEY_AudioEndpoint_FullRangeSpeakers устройства конечной точки аудио является подмножеством маски конфигурации канала для свойства PKEY_AudioEndpoint_PhysicalSpeakers того же устройства.

Например, если устройство конечной точки звука управляет набором динамиков объемного звука 5.1, маска конфигурации канала для свойства PKEY_AudioEndpoint_PhysicalSpeakers KSAUDIO_SPEAKER_5POINT1. Эта маска указывает на наличие переднего левого, переднего правого, переднего центра, бокового левого и бокового правого динамиков, а также сабвуфера. Если передние и правые динамики достаточно велики для создания басовых звуков, а меньшие передние и боковые динамики — нет, маска конфигурации канала для свойства PKEY_AudioEndpoint_FullRangeSpeakers KSAUDIO_SPEAKER_STEREO, что указывает только на передний левый и правый динамики. Маски конфигурации каналов KSAUDIO_SPEAKER_5POINT1 и KSAUDIO_SPEAKER_STEREO определяются в файле заголовка Ksmedia.h.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2008 [только классические приложения]
Заголовок
Mmdeviceapi.h

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

Свойства конечной точки аудио

Основные свойства аудио

Свойство PKEY_AudioEndpoint_PhysicalSpeakers