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

структура 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 Неизвестно Неизвестно
 

Для физического соединителя с одним, тремя или несколькими каналами значение этого элемента равно 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

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

Основные звуковые структуры

IKsJackDescription::GetJackDescription