KSJACK_DESCRIPTION 结构

项目
03/05/2024

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 的应用指示没有物理插孔。因此，也没有几何位置。例如，音频设备可以集成到主板中，而无需任何可访问的插孔。