acxelements.h 标头

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

有关详细信息，请参阅：

• ACX 音频类扩展概述

• 音频：

注意

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

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

函数

ACX_AUDIOENGINE_CALLBACKS_INIT ACX_AUDIOENGINE_CALLBACKS_INIT 函数初始化驱动程序的ACX_AUDIOENGINE_CALLBACKS结构。
ACX_AUDIOENGINE_CONFIG_INIT ACX_AUDIOENGINE_CONFIG_INIT 函数初始化驱动程序的ACX_AUDIOENGINE_CONFIG结构。
ACX_AUDIOENGINE_CONFIG_INIT_ID 由于ACX_AUDIOENGINE_CONFIG_INIT_ID提供与 ACX_AUDIOENGINE_CONFIG_INIT 相同的功能，因此建议使用 ACX_AUDIOENGINE_CONFIG_INIT。
ACX_AUDIOMODULE_CALLBACKS_INIT ACX_AUDIOMODULE_CALLBACKS_INIT 函数初始化 ACX_AUDIOMODULE_CALLBACKS 结构。
ACX_AUDIOMODULE_CONFIG_INIT ACX_AUDIOMODULE_CONFIG_INIT 函数初始化ACX_AUDIOMODULE_CONFIG结构。
ACX_AUDIOMODULE_CONFIG_INIT_ID 由于ACX_AUDIOMODULE_CONFIG_INIT_ID提供的功能与 ACX_AUDIOMODULE_CONFIG_INIT 相同，因此建议使用 ACX_AUDIOMODULE_CONFIG_INIT。
ACX_ELEMENT_CONFIG_INIT ACX_ELEMENT_CONFIG_INIT 函数初始化ACX_ELEMENT_CONFIG结构。
ACX_ELEMENT_CONFIG_INIT_ID 由于 ACX_ELEMENT_CONFIG_INIT_ID 提供与 ACX_ELEMENT_CONFIG_INIT 相同的功能，因此建议使用 ACX_ELEMENT_CONFIG_INIT。
ACX_KEYWORDSPOTTER_CALLBACKS_INIT ACX_KEYWORDSPOTTER_CALLBACKS_INIT 函数初始化 ACX_KEYWORDSPOTTER_CALLBACKS 结构。
ACX_KEYWORDSPOTTER_CONFIG_INIT ACX_KEYWORDSPOTTER_CONFIG_INIT 函数初始化ACX_KEYWORDSPOTTER_CONFIG结构。
ACX_KEYWORDSPOTTER_CONFIG_INIT_ID 由于 ACX_KEYWORDSPOTTER_CONFIG_INIT_ID 提供与 ACX_KEYWORDSPOTTER_CONFIG_INIT 相同的功能，因此建议使用 ACX_KEYWORDSPOTTER_CONFIG_INIT。
ACX_MUTE_CALLBACKS_INIT ACX_MUTE_CALLBACKS_INIT 函数初始化 ACX_MUTE_CALLBACKS 结构。
ACX_MUTE_CONFIG_INIT ACX_MUTE_CONFIG_INIT 函数初始化ACX_MUTE_CONFIG结构。
ACX_MUTE_CONFIG_INIT_ID 由于ACX_MUTE_CONFIG_INIT_ID提供与 ACX_MUTE_CONFIG_INIT 相同的功能，因此建议使用 ACX_MUTE_CONFIG_INIT。
ACX_PEAKMETER_CALLBACKS_INIT ACX_PEAKMETER_CALLBACKS_INIT 函数初始化ACX_PEAKMETER_CALLBACKS 结构。
ACX_PEAKMETER_CONFIG_INIT ACX_PEAKMETER_CONFIG_INIT 函数初始化ACX_PEAKMETER_CONFIG结构。
ACX_PEAKMETER_CONFIG_INIT_ID 由于ACX_PEAKMETER_CONFIG_INIT_ID提供的功能与 ACX_PEAKMETER_CONFIG_INIT 相同，因此建议使用 ACX_PEAKMETER_CONFIG_INIT。
ACX_STREAMAUDIOENGINE_CALLBACKS_INIT ACX_STREAMAUDIOENGINE_CALLBACKS_INIT 函数初始化ACX_STREAMAUDIOENGINE_CALLBACKS 结构。
ACX_STREAMAUDIOENGINE_CONFIG_INIT ACX_STREAMAUDIOENGINE_CONFIG_INIT 函数初始化ACX_STREAMAUDIOENGINE_CONFIG结构。
ACX_STREAMAUDIOENGINE_CONFIG_INIT_ID 由于ACX_STREAMAUDIOENGINE_CONFIG_INIT_ID提供的功能与 ACX_STREAMAUDIOENGINE_CONFIG_INIT 相同，因此建议使用 ACX_STREAMAUDIOENGINE_CONFIG_INIT。
ACX_VOLUME_CALLBACKS_INIT ACX_VOLUME_CALLBACKS_INIT 函数初始化ACX_VOLUME_CALLBACKS 结构。
ACX_VOLUME_CONFIG_INIT ACX_VOLUME_CONFIG_INIT 函数初始化ACX_VOLUME_CONFIG结构。
ACX_VOLUME_CONFIG_INIT_ID 目前，ACX_VOLUME_CONFIG_INIT_ID只能将 AcxElementIdDefault 作为元素 ID 的输入，这与使用 ACX_VOLUME_CONFIG_INIT 相同。
AcxAudioEngineCreate AcxAudioEngineCreate 函数用于创建将与线路 WDFDEVICE 设备对象父级关联的音频引擎。
AcxAudioEngineGetDeviceFormatList AcxAudioEngineGetDeviceFormatList 函数检索 ACXDATAFORMATLIST 设备格式列表 ACX 对象。
AcxAudioModuleCreate AcxAudioModuleCreate 函数用于创建将与 ACX 线路对象父级关联的音频模块。
AcxElementAddEvents AcxElementAddEvents 函数提供将 ACXEVENT 事件对象添加到 ACXELEMENT 对象的功能。
AcxElementCreate AcxElementCreate 函数用于创建将与线路或流设备对象父对象关联的 ACXELEMENT 对象。
AcxElementGetContainer AcxElementGetContainer 函数检索给定 ACX 元素的关联容器。
AcxElementGetId AcxElementGetId 函数检索表示给定 ACX 元素对象的元素 ID 的数字。
AcxKeywordSpotterCreate AcxKeywordSpotterCreate 函数用于创建将与线路设备对象父级关联的 ACX 关键字 (keyword) spotter 对象。
AcxMuteChangeStateNotification AcxMuteChangeStateNotification 函数在 ACXMUTE 对象上发送静音状态更改通知，以便 acx 可以生成相应的事件。
AcxMuteCreate AcxMuteCreate 函数用于创建将与线路对象父对象关联的 ACX 静音对象。
AcxPeakMeterCreate AcxPeakMeterCreate 函数用于创建将与线路对象父级关联的 ACX 峰值计对象。
AcxStreamAudioEngineCreate AcxStreamAudioEngineCreate 函数用于创建将与 ACX 流对象父级关联的 ACX 流音频引擎对象。
AcxStreamAudioEngineGetStream AcxStreamAudioEngineGetStream 函数检索与给定流音频引擎对象关联的 ACXSTREAM 对象。
AcxVolumeChangeLevelNotification AcxVolumeChangeLevelNotification 函数在 ACXVOLUME 对象上发送卷级别更改通知，以便 acx 可以生成相应的事件。
AcxVolumeCreate AcxVolumeCreate 函数用于创建将与线路对象父对象关联的 ACX 卷对象。

回调函数

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE回调函数由驱动程序实现，并在为音频引擎节点设置全局效果状态时调用。
EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT回调函数由驱动程序实现，并在为音频引擎节点设置内部混合格式时调用。
EVT_ACX_AUDIOENGINE_RETRIEVE_BUFFER_SIZE_LIMITS EVT_ACX_AUDIOENGINE_RETRIEVE_BUFFER_SIZE_LIMITS回调由驱动程序实现，在为指定的音频引擎请求给定数据格式的缓冲区大小限制时调用。
EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE回调函数由驱动程序实现，并在为指定的音频引擎节点请求全局效果状态时调用。
EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT回调由驱动程序实现，并在为指定的音频引擎请求内部混合格式时调用。
EVT_ACX_AUDIOMODULE_PROCESSCOMMAND EVT_ACX_AUDIOMODULE_PROCESSCOMMAND告知驱动程序处理音频模块元素的命令。
EVT_ACX_KEYWORDSPOTTER_ASSIGN_ARM EVT_ACX_KEYWORDSPOTTER_ASSIGN_ARM设置关键字 (keyword) 发现器的臂状态。
EVT_ACX_KEYWORDSPOTTER_ASSIGN_PATTERNS EVT_ACX_KEYWORDSPOTTER_ASSIGN_PATTERNS为关键字 (keyword) 检测器使用的关键字 (keyword) 检测分配检测模式。
EVT_ACX_KEYWORDSPOTTER_ASSIGN_RESET EVT_ACX_KEYWORDSPOTTER_ASSIGN_RESET将关键字 (keyword) 检测器重置为未设置模式的手无寸铁状态。
EVT_ACX_KEYWORDSPOTTER_RETRIEVE_ARM EVT_ACX_KEYWORDSPOTTER_RETRIEVE_ARM检索关键字 (keyword) 发现器当前臂状态。
EVT_ACX_MUTE_ASSIGN_STATE EVT_ACX_MUTE_ASSIGN_STATE回调函数由驱动程序实现，并在设置静音节点上指定通道的状态时调用。
EVT_ACX_MUTE_RETRIEVE_STATE EVT_ACX_MUTE_RETRIEVE_STATE回调函数由驱动程序实现，并在请求静音节点上指定通道的状态时调用。
EVT_ACX_PEAKMETER_RETRIEVE_LEVEL EVT_ACX_PEAKMETER_RETRIEVE_LEVEL回调函数由驱动程序实现，并在请求峰值计节点上指定通道的级别时调用。
EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL由驱动程序实现，在为卷节点设置通道的音量级别时调用。
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_CURRENT_WRITE_POSITION EVT_ACX_STREAMAUDIOENGINE_ASSIGN_CURRENT_WRITE_POSITION回调函数由驱动程序实现，并在设置指定流音频引擎的当前写入位置时调用。
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE回调函数由驱动程序实现，并在为流音频引擎节点设置本地效果状态时调用。
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LAST_BUFFER_POSITION EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LAST_BUFFER_POSITION回调函数由驱动程序实现，并在为指定的流音频引擎设置音频缓冲区中最后一个有效字节的位置时调用。
EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION EVT_ACX_STREAMAUDIOENGINE_ASSIGN_LOOPBACK_PROTECTION由驱动程序实现，并在为流音频引擎节点设置环回保护状态时调用。
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_EFFECTS_STATE回调函数由驱动程序实现，并在为指定的流音频引擎请求本地效果状态时调用。
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_LINEAR_BUFFER_POSITION EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_LINEAR_BUFFER_POSITION回调由驱动程序实现，并在为指定的流音频引擎请求线性缓冲区位置时调用。
EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_PRESENTATION_POSITION EVT_ACX_STREAMAUDIOENGINE_RETRIEVE_PRESENTATION_POSITION回调函数由驱动程序实现，调用该函数以检索正在呈现到流音频引擎节点的音频数据中的当前位置。
EVT_ACX_VOLUME_ASSIGN_LEVEL EVT_ACX_VOLUME_ASSIGN_LEVEL回调函数由驱动程序实现，并在为卷节点设置通道的音量级别时调用。
EVT_ACX_VOLUME_RETRIEVE_LEVEL EVT_ACX_VOLUME_RETRIEVE_LEVEL回调函数由驱动程序实现，并在请求卷节点上指定通道的音量级别时调用。

结构

ACX_AUDIOENGINE_CALLBACKS ACX_AUDIOENGINE_CALLBACKS 结构定义 ACX 音频引擎的回调。
ACX_AUDIOENGINE_CONFIG ACX_AUDIOENGINE_CONFIG 结构用于定义音频引擎配置。
ACX_AUDIOMODULE_CALLBACKS ACX_AUDIOMODULE_CALLBACKS 结构标识 ACX 音频模块操作的驱动程序回调。
ACX_AUDIOMODULE_CONFIG ACX_AUDIOMODULE_CONFIG 结构用于定义音频模块配置。
ACX_AUDIOMODULE_DESCRIPTOR ACX_AUDIOMODULE_DESCRIPTOR用于定义音频模块描述符结构。
ACX_ELEMENT_CONFIG ACX_ELEMENT_CONFIG 结构用于定义音频元素配置。
ACX_KEYWORDSPOTTER_CALLBACKS ACX_KEYWORDSPOTTER_CALLBACKS结构标识关键字查找器操作的驱动程序回调。
ACX_KEYWORDSPOTTER_CONFIG ACX_KEYWORDSPOTTER_CONFIG 结构用于定义音频关键字 (keyword) 发现器配置。
ACX_MUTE_CALLBACKS ACX_MUTE_CALLBACKS结构标识 ACX 静音操作的驱动程序回调。
ACX_MUTE_CONFIG ACX_MUTE_CONFIG 结构用于定义音频静音配置。
ACX_PEAKMETER_CALLBACKS ACX_PEAKMETER_CALLBACKS 结构标识 ACX 峰值计操作的驱动程序回调。
ACX_PEAKMETER_CONFIG ACX_PEAKMETER_CONFIG 结构用于定义音频峰值计配置。
ACX_STREAMAUDIOENGINE_CALLBACKS ACX_STREAMAUDIOENGINE_CALLBACKS 结构标识 ACX 音频引擎流操作的驱动程序回调。
ACX_STREAMAUDIOENGINE_CONFIG ACX_STREAMAUDIOENGINE_CONFIG 结构用于定义音频引擎流配置。
ACX_VOLUME_CALLBACKS ACX_VOLUME_CALLBACKS 结构标识 ACX 卷操作的驱动程序回调。
ACX_VOLUME_CONFIG ACX_VOLUME_CONFIG 结构用于定义 acx 卷配置。

枚举

ACX_AUDIOENGINE_CONFIG_FLAGS ACX_AUDIOENGINE_CONFIG_FLAGS 枚举定义 ACX 音频引擎的配置标志。
ACX_AUDIOMODULE_CONFIG_FLAGS ACX_AUDIOMODULE_CONFIG_FLAGS 枚举定义 ACX 音频模块的配置标志。
ACX_CONSTRICTOR_OPTION ACX_CONSTRICTOR_OPTION 枚举定义流音频引擎节点的环回保护状态的选项。
ACX_ELEMENT_CONFIG_FLAGS ACX_ELEMENT_CONFIG_FLAGS 枚举定义 ACX 元素的配置标志。
ACX_KEYWORDSPOTTER_CONFIG_FLAGS ACX_KEYWORDSPOTTER_CONFIG_FLAGS 枚举定义 ACX 音频关键字 (keyword) 识别器的配置标志。
ACX_MUTE_CONFIG_FLAGS ACX_MUTE_CONFIG_FLAGS 枚举定义 ACX 静音元素的配置标志。
ACX_PEAKMETER_CONFIG_FLAGS ACX_PEAKMETER_CONFIG_FLAGS枚举定义 ACX 峰值计元素的配置标志。
ACX_STREAMAUDIOENGINE_CONFIG_FLAGS ACX_STREAMAUDIOENGINE_CONFIG_FLAGS 枚举定义 ACX 流音频引擎的配置标志。
ACX_VOLUME_CONFIG_FLAGS ACX_VOLUME_CONFIG_FLAGS枚举定义 ACX 卷元素的配置标志。
ACX_VOLUME_CURVE_TYPE ACX_VOLUME_CURVE_TYPE 枚举定义常量，这些常量指定要应用于设置音量的曲线算法。