структура 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 | Задний |
| eGeoLocFront | Фронт |
| eGeoLocLeft | Налево |
| eGeoLocRight | Правильно |
| eGeoLocTop | Вверх |
| eGeoLocBottom | Дно |
| eGeoLocRearPanel | Задняя панель с открытым слайдом или вытягиванием |
| eGeoLocRiser | Карточка подъема |
| 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 |