структура KSJACK_DESCRIPTION
Структура KSJACK_DESCRIPTION определяет физические атрибуты аудиоразъема.
Синтаксис
typedef struct {
DWORD ChannelMapping;
DWORD Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Члены
ChannelMapping
Указывает сопоставление звуковых каналов с соответствующими положениями динамиков. ChannelMapping — это битовая маска флагов KSAUDIO_SPEAKER_XXX (например, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), которые определены в файле заголовка Ksmedia.h. ChannelMapping должен быть ненулевым только для аналоговых контактов отрисовки. Для контактов захвата или для контактов цифровой отрисовки установите для этого элемента значение 0.
Примечание
Devicetopology.h изначально определял ChannelMapping как перечисление типа EChannelMapping. С тех пор перечисление EChannelMapping устарело и больше не используется в Windows Vista и более поздних версиях операционных систем Windows.
Цвет
Задает цвет разъема. Цвет выражается в виде 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 |
Сочетание соединителей |
Географического расположения
Геометрическое расположение гнезда. Значение этого элемента является одним из значений перечисления 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 |
Неизвестно |
IsConnected
Указывает, подключено ли к разъему внешнее устройство. Если звуковой контроллер поддерживает обнаружение разъема на этом контакте, значение IsConnected должно точно указывать, занят ли разъем разъемом в любой момент времени. Это значение всегда должно быть равно TRUE для устройств, которые не поддерживают обнаружение разъема.
Комментарии
Эта структура используется свойством KSPROPERTY_JACK_DESCRIPTION в Windows Vista и более поздних версиях. В нем описывается аудиоразъем, который является частью подключения между конечным устройством и аппаратным устройством в звуковом адаптере. Когда пользователю необходимо подключить устройство конечной точки к разъему или отключить его от разъема, звуковое приложение может использовать описательные сведения в структуре, чтобы помочь пользователю найти разъем.
Если звуковое устройство не предоставляет физически доступный разъем, звуковое устройство использует значение eGeoLocNotApplicable , чтобы указать приложениям Windows и Windows, что физического разъема нет. Таким образом, геометрическое расположение также не существует. Например, звуковое устройство можно интегрировать в системную плату без доступных разъемов.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |