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 |
连接器组合 |
GeoLocation
插孔的几何位置。 此成员的值是下表中显示的 EPcxGeoLocation 枚举值之一。
| 值 | 几何位置 |
|---|---|
eGeoLocRear |
Rear |
eGeoLocFront |
Front |
eGeoLocLeft |
Left |
eGeoLocRight |
Right |
eGeoLocTop |
上限 |
eGeoLocBottom |
下 |
eGeoLocRearPanel |
后滑动打开或拉开面板 |
eGeoLocRiser |
转接卡 |
eGeoLocInsideMobileLid |
移动计算机的内盖 |
eGeoLocDrivebay |
驱动器舱 |
eGeoLocHDMI |
HDMI 连接器 |
eGeoLocOutsideMobileLid |
移动计算机的外盖 |
eGeoLocATAPI |
ATAPI 连接器 |
eGeoLocNotApplicable |
不适用。 请参阅“备注”部分。 |
GenLocation
指定插孔的常规位置。 此成员的值是下表中显示的 EPcxGenLocation 枚举值之一。
| 值 | 常规位置 |
|---|---|
eGenLocPrimaryBox |
在主底盘上 |
eGenLocInternal |
主底盘内部 |
eGenLocSeparate |
在单独的底盘上 |
eGenLocOther |
其他位置 |
PortConnection
指定由插孔表示的端口的类型。 此成员的值是下表中显示的 EPxcPortConnection 枚举值之一。
| 值 | 端口连接类型 |
|---|---|
ePortConnJack |
Jack |
ePortConnIntegratedDevice |
集成设备的槽 |
ePortConnBothIntegratedAndJack |
集成设备的插孔和槽 |
ePortConnUnknown |
未知 |
IsConnected
指示是否存在连接到插孔的外部设备。 如果音频控制器支持此引脚上的插孔检测，则 IsConnected 应准确指示插孔是否在任何给定时间被插件占用。 对于不支持插孔检测的设备，此值应始终设置为 TRUE。
注解
此结构由 Windows Vista 及更高版本中的 KSPROPERTY_JACK_DESCRIPTION 属性使用。 它描述一个音频插孔，该插孔是终结点设备和音频适配器中硬件设备之间的连接的一部分。 当用户需要将终结点设备插入插孔或将其从插孔中拔出时，音频应用程序可以使用结构中的描述性信息来帮助用户查找插孔。
当音频设备不公开物理可访问的插孔时，音频设备使用 eGeoLocNotApplicable 值向 Windows 和基于 Windows 的应用指示没有物理插孔。 因此，也没有几何位置。 例如，音频设备可以集成到主板中，而无需任何可访问的插孔。
要求
标头 |
Ksmedia.h（包括 Ksmedia.h） |