acxpin.h) (ACX_JACK_DESCRIPTION 结构

ACX_JACK_DESCRIPTION结构描述音频插孔的属性，例如连接类型、物理位置等。

语法

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

成员

ChannelMapping

指定音频通道到相应扬声器位置的映射。 ChannelMapping 是KSAUDIO_SPEAKER_XXX标志的位掩码， (例如 SPEAKER_FRONT_LEFT |SPEAKER_FRONT_RIGHT) ，在头文件 Ksmedia.h 中定义。 ChannelMapping 应仅为模拟呈现引脚的非零值。 对于捕获引脚或数字呈现插针，将此成员设置为 0。

Color

指定插孔颜色。 颜色表示为 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	Riser 卡
eGeoLocInsideMobileLid	移动计算机盖子内部
eGeoLocDrivebay	驱动器托架
eGeoLocHDMI	HDMI 连接器
eGeoLocOutsideMobileLid	移动计算机的外盖
eGeoLocATAPI	ATAPI 连接器
eGeoLocNotApplicable	不适用。 请参阅 “备注 ”部分。

GenLocation

指定插孔的一般位置。 此成员的值是下表所示的 EPcxGenLocation 枚举值之一。

值	常规位置
eGenLocPrimaryBox	在主底盘上
eGenLocInternal	主底盘内部
eGenLocSeparate	在单独的底盘上
eGenLocOther	其他位置

PortConnection

指定插孔表示的端口类型。 此成员的值是下表所示的 EPxcPortConnection 枚举值之一。

值	端口连接类型
ePortConnJack	杰克
ePortConnIntegratedDevice	集成设备的槽
ePortConnBothIntegratedAndJack	集成设备的插孔和插槽
ePortConnUnknown	未知

注解

此结构描述音频插孔，该插孔是音频适配器中终结点设备和硬件设备之间的连接的一部分。 当用户需要将终结点设备插入插孔或将其从插孔中拔下时，音频应用程序可以使用 结构中的描述性信息来帮助用户查找插孔。

当音频设备不公开物理可访问的插孔时，音频设备使用 eGeoLocNotApplicable 值向基于 Windows 和 Windows 的应用指示没有物理插孔。 因此，也没有几何位置。 例如，音频设备可以集成到主板中，而无需任何可访问的插孔。

ACX 要求

最低 ACX 版本： 1.0

有关 ACX 版本的详细信息，请参阅 ACX 版本概述。

要求

要求	值
Header	acxpin.h

另请参阅

• acxpin.h 标头