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 |