структура ACX_JACK_DESCRIPTION (acxpin.h)

Структура ACX_JACK_DESCRIPTION описывает атрибуты аудиоразъема, такие как тип подключения, физическое расположение и т. д.

Синтаксис

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

Члены

ChannelMapping

Задает сопоставление звуковых каналов с соответствующими положениями динамиков. ChannelMapping — это битовая маска флагов KSAUDIO_SPEAKER_XXX (например, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), которые определены в файле заголовка Ksmedia.h. ChannelMapping должен быть ненулевым только для аналоговых контактов отрисовки. Для контактов захвата или для контактов цифровой отрисовки задайте для этого элемента значение 0.

Color

Задает цвет разъема. Цвет выражается в виде 32-разрядного значения RGB, которое формируется путем объединения 8-разрядных компонентов синего, зеленого и красного цветов. Синий компонент занимает 8 наименее значимых битов (биты 0–7), зеленый компонент занимает биты 8–15, а красный компонент — биты 16–23. 8 наиболее значимых битов — это нули. Если цвет разъема неизвестен или физический соединитель не имеет идентифицируемый цвет, значение этого элемента будет 0x00000000, которое представляет черный цвет.

ConnectionType

Указывает физический тип подключения для этого разъема. Значение этого элемента является одним из значений перечисления EPcxConnectionType , показанных в следующей таблице.

Значение Тип соединителя
eConnTypeUnknown Неизвестно
eConnType3Point5mm Миниджек 3,5 мм
eConnTypeQuarter 1/4-дюймовый разъем
eConnTypeAtapiInternal Внутренний соединитель ATAPI
eConnTypeRCA Разъем RCA
eConnTypeOptical Оптический соединитель
eConnTypeOtherDigital Универсальный цифровой соединитель
eConnTypeOtherAnalog Универсальный аналоговый соединитель
eConnTypeMultichannelAnalogDIN Многоканальный аналоговый соединитель DIN
eConnTypeXlrProfessional Соединитель XLR
eConnTypeRJ11Modem Соединитель модема RJ11
eConnTypeCombination Сочетание соединителей

GeoLocation

Геометрическое расположение домкрата. Значение этого элемента является одним из значений перечисления EPcxGeoLocation , показанных в следующей таблице.

Значение Геометрическое расположение
eGeoLocRear Rear
eGeoLocFront Front
eGeoLocLeft Левый
eGeoLocRight Правый
eGeoLocTop TOP
eGeoLocBottom Последние
eGeoLocRearPanel Задняя панель с открытым слайдом или открытой по запросу
eGeoLocRiser Карта riser
eGeoLocInsideMobileLid Внутри крышки мобильного компьютера
eGeoLocDrivebay Отсек для дисков
eGeoLocHDMI Соединитель HDMI
eGeoLocOutsideMobileLid Внешняя крышка мобильного компьютера
eGeoLocATAPI Соединитель ATAPI
eGeoLocNotApplicable Не применяется См. раздел Примечания .

GenLocation

Указывает общее расположение разъема. Значение этого элемента является одним из значений перечисления EPcxGenLocation , показанных в следующей таблице.

Значение Общее расположение
eGenLocPrimaryBox На основном корпусе
eGenLocInternal Внутри основного корпуса
eGenLocSeparate На отдельном корпусе
eGenLocOther Другое расположение

PortConnection

Указывает тип порта, представленного разъемом. Значение этого элемента является одним из значений перечисления EPxcPortConnection , показанных в следующей таблице.

Значение Тип подключения к порту
ePortConnJack Джек
ePortConnIntegratedDevice Слот для интегрированного устройства
ePortConnBothIntegratedAndJack Разъем и слот для интегрированного устройства
ePortConnUnknown Неизвестно

Комментарии

Эта структура описывает аудиоразъем, который является частью соединения между конечным устройством и аппаратным устройством в звуковом адаптере. Когда пользователю необходимо подключить устройство конечной точки к разъему или отключить его от разъема, звуковое приложение может использовать описательные сведения в структуре, чтобы помочь пользователю найти разъем.

Если звуковое устройство не предоставляет физически доступный разъем, звуковое устройство использует значение eGeoLocNotApplicable , чтобы указать Windows и приложениям windows, что физического разъема нет. Таким образом, геометрическое расположение также отсутствует. Например, звуковое устройство можно интегрировать в системную плату без доступных разъемов.

Требования к ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование Значение
Заголовок acxpin.h

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