acxpin.h 标头

ACX 音频类扩展使用此标头。

有关详细信息，请参阅：

• ACX 音频类扩展概述

• 音频：

注意

ACX 标头和库不包括在 2023 年 10 月 24 日发布的 WDK 10.0.22621.2428 () 中，但在早期版本中提供，以及最新的 (25000 系列内部版本) WDK Insider Preview。 有关 WDK 预览版的详细信息，请参阅 安装 Windows 驱动程序工具包的预览版本 (WDK) 。

acxpin.h 包含以下编程接口：

函数

ACX_CONNECTION_INIT 初始化ACX_CONNECTION结构，以便在配置连接时使用。
ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION_INIT ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION_INIT 函数初始化ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION结构以供使用。
ACX_JACK_CALLBACKS_INIT ACX_JACK_CALLBACKS_INIT 函数初始化ACX_JACK_CALLBACKS结构以供使用。
ACX_JACK_CONFIG_INIT ACX_JACK_CONFIG_INIT宏使用默认 ID 值调用 ACX_JACK_CONFIG_INIT_ID 函数。
ACX_JACK_CONFIG_INIT_ID ACX_JACK_CONFIG_INIT_ID 函数使用指定的 ID 初始化ACX_JACK_CONFIG结构。
ACX_MICARRAYGEOMETRY_CONFIG_INIT ACX_MICARRAYGEOMETRY_CONFIG_INIT 函数初始化ACX_MICARRAYGEOMETRY_CONFIG结构以供使用。
ACX_MICROPHONE_CONFIG_INIT ACX_MICROPHONE_CONFIG_INIT 函数初始化了ACX_MICROPHONE_CONFIG 结构以供使用。
ACX_PHYSICAL_CONNECTION_INIT ACX_PHYSICAL_CONNECTION_INIT 函数初始化ACX_PHYSICAL_CONNECTION结构以供使用。
ACX_PIN_CALLBACKS_INIT ACX_PIN_CALLBACKS_INIT 函数初始化ACX_PIN_CALLBACKS结构以供使用。
ACX_PIN_CONFIG_INIT ACX_PIN_CONFIG_INIT 宏使用默认 ID 值调用 ACX_PIN_CONFIG_INIT_ID 函数。
ACX_PIN_CONFIG_INIT_ID ACX_PIN_CONFIG_INIT_ID 函数使用指定的 ID 初始化ACX_PIN_CONFIG结构。
AcxJackChangeStateNotification AcxJackChangeStateNotification 函数指示指定插孔的状态发生了更改。
AcxJackCreate AcxJackCreate 函数创建并初始化新的音频插孔对象。
AcxMicArrayGeometryAddMicrophoneCoordinates AcxMicArrayGeometryAddMicrophoneCoordinates 函数将物理坐标添加到麦克风阵列几何图形。
AcxMicArrayGeometryCreate AcxMicArrayGeometryCreate 函数创建并初始化新的 ACXMICARRAYGEOMETRY 对象。
AcxPinAddEvents AcxPinAddEvents 函数将事件数组添加到指定的引脚。
AcxPinAddJacks AcxPinAddJacks 函数将插孔数组添加到指定的引脚。
AcxPinAddStreamBridges AcxPinAddStreamBridges 函数将流桥添加到指定的引脚。
AcxPinAssignModeDataFormatList AcxPinAssignModeDataFormatList 函数将模式数据格式列表分配给指定的引脚。
AcxPinCreate AcxPinCreate 函数创建并初始化新的 ACXPIN 对象。
AcxPinGetCircuit AcxPinGetCircuit 函数返回引脚连接到的线路。
AcxPinGetId AcxPinGetId 函数返回指定引脚的 ID。
AcxPinGetRawDataFormatList AcxPinGetRawDataFormatList 函数返回指定引脚的原始模式数据格式列表。
AcxPinGetType AcxPinGetType 函数返回指定引脚的类型。
AcxPinNotifyDataFormatChange 调用 AcxPinNotifyDataFormatChange 函数，为指定的引脚生成数据格式更改通知事件。
AcxPinRemoveModeDataFormatList AcxPinRemoveModeDataFormatList 函数删除指定引脚的模式数据格式列表。
AcxPinRemoveStreamBridges AcxPinRemoveStreamBridges 函数从指定的引脚中删除 ACXSTREAMBRIDGE 对象。
AcxPinRetrieveModeDataFormatList AcxPinRetrieveModeDataFormatList 函数获取指定引脚的模式数据格式列表。

回调函数

EVT_ACX_JACK_RETRIEVE_PRESENCE_STATE EVT_ACX_JACK_RETRIEVE_PRESENCE_STATE回调函数由驱动程序实现，并在为指定的插孔请求状态时调用。
EVT_ACX_PIN_CONNECTED EVT_ACX_PIN_CONNECTED回调函数由驱动程序实现，当线路桥接引脚连接到另一个线路的桥接引脚时调用。
EVT_ACX_PIN_DATAFORMAT_CHANGE_NOTIFICATION EVT_ACX_PIN_DATAFORMAT_CHANGE_NOTIFICATION回调函数由驱动程序实现，并在指定引脚上发生数据格式更改时调用。
EVT_ACX_PIN_DISCONNECTED EVT_ACX_PIN_DISCONNECTED回调函数由驱动程序实现，当线路桥引脚与另一个线路的引脚断开连接时调用。
EVT_ACX_PIN_RETRIEVE_JACK_SINK_INFO EVT_ACX_PIN_RETRIEVE_JACK_SINK_INFO回调函数由驱动程序实现，并在为指定引脚请求接收器信息时调用。
EVT_ACX_PIN_RETRIEVE_NAME EVT_ACX_PIN_RETRIEVE_NAME回调函数由驱动程序实现，并在为指定引脚请求名称时调用。
EVT_ACX_PIN_SET_DATAFORMAT EVT_ACX_PIN_SET_DATAFORMAT回调函数由驱动程序实现，并调用 该函数来设置指定引脚的数据格式。

结构

ACX_CONNECTION ACX_CONNECTION 结构用于定义两个引脚之间的连接。
ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION ACX_INTERLEAVED_AUDIO_FORMAT_INFORMATION结构指定环回音频如何与麦克风音频交错，以便KSPROPERTY_INTERLEAVEDAUDIO_FORMATINFORMATION。
ACX_JACK_CALLBACKS ACX_JACK_CALLBACKS 结构指定音频插孔事件回调函数。
ACX_JACK_CONFIG ACX_JACK_CONFIG 结构用于配置音频插孔。
ACX_JACK_DESCRIPTION ACX_JACK_DESCRIPTION结构描述音频插孔的属性，例如连接类型、物理位置等。
ACX_JACK_SINK_INFORMATION ACX_JACK_SINK_INFORMATION结构指定有关与显示器相关的数字音频设备的信息，例如 HDMI 设备或显示端口。
ACX_MIC_ARRAY_GEOMETRY ACX_MIC_ARRAY_GEOMETRY 结构指定麦克风阵列的类型和几何图形。
ACX_MICARRAYGEOMETRY_CONFIG ACX_MICARRAYGEOMETRY_CONFIG 结构用于配置麦克风阵列。
ACX_MICROPHONE_CONFIG ACX_MICROPHONE_CONFIG结构用于配置麦克风。
ACX_MICROPHONE_COORDINATES ACX_MICROPHONE_COORDINATES结构以 X、Y 和 Z 坐标指定麦克风的 3D 位置。
ACX_PHYSICAL_CONNECTION ACX_PHYSICAL_CONNECTION 结构描述两个 ACXCIRCUIT 对象之间的物理音频连接。
ACX_PIN_CALLBACKS ACX_PIN_CALLBACKS 结构指定固定事件回调函数。
ACX_PIN_CONFIG ACX_PIN_CONFIG结构用于配置引脚。

枚举

ACX_CONNECTION_FLAGS ACX_CONNECTION 结构使用 ACX_CONNECTION_FLAGS 枚举来指定 ACX 对象标识符类型。
ACX_JACK_CONFIG_FLAGS ACX_JACK_CONFIG_FLAGS 枚举用于将物理插孔的属性描述为音频类扩展 (ACX) 。
ACX_JACK_CONNECTION_TYPE ACX_JACK_CONNECTION_TYPE 枚举用于描述物理连接插孔的类型。
ACX_JACK_GEN_LOCATION ACX_JACK_DESCRIPTION 结构使用 ACX_JACK_GEN_LOCATION 枚举来帮助描述系统中音频插孔的一般位置。
ACX_JACK_GEO_LOCATION ACX_JACK_DESCRIPTION 结构使用ACX_JACK_GEO_LOCATION枚举来帮助描述音频插孔的几何位置。
ACX_JACK_PORT_CONNECTION ACX_JACK_PORT_CONNECTION 枚举由 ACX_JACK_DESCRIPTION 结构使用，并指定插孔表示的端口类型。
ACX_JACK_SINK_INFO_CONNECTION_TYPE ACX_JACK_SINK_INFO_CONNECTION_TYPE 枚举由 ACX_JACK_SINK_INFORMATION 结构用来指定连接的类型。
ACX_MIC_ARRAY_TYPE ACX_MIC_ARRAY_TYPE枚举用于指定麦克风阵列的类型。
ACX_MICARRAYGEOMETRY_CONFIG_FLAGS ACX_MICARRAYGEOMETRY_CONFIG_FLAGS 枚举用于配置麦克风阵列的几何图形。
ACX_MICROPHONE_CONFIG_FLAGS ACX_MICROPHONE_CONFIG_FLAGS 枚举用于配置物理麦克风。
ACX_MICROPHONE_TYPE ACX_MICROPHONE_TYPE枚举用于标识麦克风的拾取模式。
ACX_PHYSICAL_CONNECTION_FLAGS ACX_PHYSICAL_CONNECTION 结构使用 ACX_PHYSICAL_CONNECTION_FLAGS 枚举来初始化物理连接。
ACX_PIN_COMMUNICATION ACX_PIN_CONFIG 结构使用 ACX_PIN_COMMUNICATION 枚举来指示引脚的通信类型。
ACX_PIN_CONFIG_FLAGS ACX_PIN_CONFIG_FLAGS 枚举指定ACX_PIN_CONFIG结构中使用的引脚配置设置。
ACX_PIN_QUALIFIER ACX_PIN_QUALIFIER 枚举指定 PIN 在多线路音频拓扑中的连接方式。
ACX_PIN_TYPE ACX_PIN_CONFIG 结构使用ACX_PIN_TYPE枚举来指示引脚的类型。