структура KSJACK_DESCRIPTION (devicetopology.h)
Структура KSJACK_DESCRIPTION описывает аудиоразъем.
Синтаксис
typedef struct __MIDL___MIDL_itf_devicetopology_0000_0000_0009 {
DWORD ChannelMapping;
COLORREF Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Члены
ChannelMapping
Задает сопоставление двух аудиоканалов в стереоразъеме с положением динамиков.
В Windows Vista значение этого элемента является одним из значений перечисления EChannelMapping , показанных в следующей таблице.
| Значение | Первый канал | Второй канал |
|---|---|---|
| ePcxChanMap_FL_FR | Передний левый динамик | Передний правый динамик |
| ePcxChanMap_FC_LFE | Динамик переднего плана | Динамик низкочастотных эффектов (сабвуфер) |
| ePcxChanMap_BL_BR | Левый динамик | Задние правые динамики |
| ePcxChanMap_FLC_FRC | Передний левый центральный динамик | Передний правый центральный динамик |
| ePcxChanMap_SL_SR | Боковой левый динамик | Боковой правый динамик |
| ePcxChanMap_Unknown | Неизвестно | Неизвестно |
В Windows 7 перечисление EChannelMapping устарело. Тип данных этого элемента — DWORD. Этот элемент хранит либо 0, либо побитовую комбинацию одного или нескольких следующих значений, определенных в Ksmedia.h.
#define SPEAKER_FRONT_LEFT 0x1
#define SPEAKER_FRONT_RIGHT 0x2
#define SPEAKER_FRONT_CENTER 0x4
#define SPEAKER_LOW_FREQUENCY 0x8
#define SPEAKER_BACK_LEFT 0x10
#define SPEAKER_BACK_RIGHT 0x20
#define SPEAKER_FRONT_LEFT_OF_CENTER 0x40
#define SPEAKER_FRONT_RIGHT_OF_CENTER 0x80
#define SPEAKER_BACK_CENTER 0x100
#define SPEAKER_SIDE_LEFT 0x200
#define SPEAKER_SIDE_RIGHT 0x400
#define SPEAKER_TOP_CENTER 0x800
#define SPEAKER_TOP_FRONT_LEFT 0x1000
#define SPEAKER_TOP_FRONT_CENTER 0x2000
#define SPEAKER_TOP_FRONT_RIGHT 0x4000
#define SPEAKER_TOP_BACK_LEFT 0x8000
#define SPEAKER_TOP_BACK_CENTER 0x10000
#define SPEAKER_TOP_BACK_RIGHT 0x20000
Color
Цвет гнезда. Цвет выражается в виде 32-разрядного значения RGB, которое формируется путем объединения 8-разрядных компонентов синего, зеленого и красного цветов. Синий компонент занимает 8 наименее значимых битов (биты 0–7), зеленый компонент занимает биты 8–15, а красный компонент — биты 16–23. 8 наиболее значимых битов — это нули. Если цвет разъема неизвестен или физический соединитель не имеет идентифицируемый цвет, значение этого элемента будет 0x00000000, то есть черный.
ConnectionType
Тип подключения. Значение этого элемента является одним из значений перечисления EPcxConnectionType , показанных в следующей таблице.
| Значение | Тип соединителя |
|---|---|
| eConnTypeUnknown | Неизвестно |
|
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7) |
1/8-дюймовый разъем |
| 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 | Панель снизу |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
Задняя панель с открытым слайдом или открытой по запросу |
| eGeoLocRiser | Карта riser |
| eGeoLocInsideMobileLid | Внутри крышки мобильного компьютера |
| eGeoLocDrivebay | Отсек для дисков |
| eGeoLocHDMI | Соединитель HDMI |
| eGeoLocOutsideMobileLid | Внешняя крышка мобильного компьютера |
| eGeoLocATAPI | Соединитель ATAPI |
GenLocation
Общее расположение разъема. Значение этого элемента является одним из значений перечисления EPcxGenLocation , показанных в следующей таблице.
| Значение | Общее расположение |
|---|---|
| eGenLocPrimaryBox | На основном корпусе |
| eGenLocInternal | Внутри основного корпуса |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
На отдельном корпусе |
| eGenLocOther | Другое расположение |
PortConnection
Тип порта, представленного разъемом. Значение этого элемента является одним из значений перечисления EPxcPortConnection , показанных в следующей таблице.
| Значение | Тип подключения к порту |
|---|---|
| ePortConnJack | Джек |
| ePortConnIntegratedDevice | Слот для интегрированного устройства |
| ePortConnBothIntegratedAndJack | Разъем и слот для интегрированного устройства |
| ePortConnUnknown | Неизвестно |
IsConnected
Если аудиоадаптер поддерживает обнаружение присутствия разъема в разъеме, значение IsConnected указывает, подключено ли устройство конечной точки к разъему. Если isConnected имеет значение TRUE, устройство подключено. Если имеет значение FALSE, разъем пуст. Для устройств, которые не поддерживают обнаружение наличия разъема, этот элемент всегда имеет значение TRUE. Дополнительные сведения об обнаружении разъема см. в разделе Устройства конечных точек аудио.
Комментарии
Эта структура используется методом IKsJackDescription::GetJackDescription в API DeviceTopology. Он описывает аудиоразъем, который является частью подключения между конечным устройством и аппаратным устройством в звуковом адаптере. Когда пользователю необходимо подключить устройство конечной точки к разъему или отключить его от разъема, звуковое приложение может использовать описательные сведения в структуре, чтобы помочь пользователю найти разъем.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Верхняя часть | devicetopology.h |