структура 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 |