acxcircuit.h 标头

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

有关详细信息，请参阅：

• ACX 音频类扩展概述

• 音频：

注意

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

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

函数

ACX_CIRCUIT_COMPOSITE_CALLBACKS_INIT ACX_CIRCUIT_COMPOSITE_CALLBACKS_INIT 函数初始化ACX_CIRCUIT_COMPOSITE_CALLBACKS结构。
ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT 函数初始化ACX_CIRCUIT_PNPPOWER_CALLBACKS结构。
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_INIT ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_INIT 函数初始化ACX_FACTORY_CIRCUIT_ADD_CIRCUIT结构。
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS_INIT ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS_INIT 函数初始化ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS配置结构。
ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS_INIT ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS_INIT 函数初始化ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS结构。
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_INIT ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_INIT 函数初始化ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT结构。
AcxCircuitAddConnections AcxCircuitAddConnections 函数将连接添加到 ACXCIRCUIT。
AcxCircuitAddElements AcxCircuitAddElements 函数将元素添加到 ACXCIRCUIT。
AcxCircuitAddEvents AcxCircuitAddEvents 函数将一个或多个事件添加到 ACXCIRCUIT。
AcxCircuitAddPhysicalConnections AcxCircuitAddPhysicalConnections 函数将物理连接添加到 ACXCIRCUIT。
AcxCircuitAddPins AcxCircuitAddPins 函数将引脚添加到 ACXCIRCUIT。
AcxCircuitCreate AcxCircuitCreate 函数用于创建 ACXCIRCUIT。
AcxCircuitDispatchAcxRequest AcxCircuitDispatchAcxRequest 将 ACX WDFREQUEST 对象调度到将管理请求的 ACX 框架。
AcxCircuitGetElementById 如果提供有效的 ElementID 编号，AcxCircuitGetElementById 函数将返回相应的 ACXELEMENT 对象。
AcxCircuitGetElementsCount AcxCircuitGetElementsCount 函数检索附加到指定 ACX 线路的元素数。
AcxCircuitGetNotificationId AcxCircuitGetNotificationId 函数检索用于指定 ACX 线路的音频模块通知的即插即用通知 ID。
AcxCircuitGetPinById 如果提供有效的 PinID 编号，AcxCircuitGetPinById 函数将返回相应的 ACXPIN 对象。
AcxCircuitGetPinsCount AcxCircuitGetPinsCount 函数检索指定线路对象的引脚数。
AcxCircuitGetSymbolicLinkName AcxCircuitGetSymbolicLinkName 函数检索指定线路对象的符号链接名称。
AcxCircuitGetWdfDevice 给定现有的 ACX Circuit 对象，AcxCircuitGetWdfDevice 函数返回关联的 WDFDEVICE 对象。
AcxCircuitInitAllocate AcxCircuitInitAllocate 函数用于初始化 AcxCircuitCreate 函数使用的不透明ACXCIRCUIT_INIT结构。
AcxCircuitInitAssignAcxCreateStreamCallback AcxCircuitInitAssignAcxCreateStreamCallback 函数用于分配 ACX 创建流回调。
AcxCircuitInitAssignAcxRequestPreprocessCallback AcxCircuitInitAssignAcxRequestPreprocessCallback 函数添加 WDFREQUEST 预处理回调。
AcxCircuitInitAssignCategories AcxCircuitInitAssignCategories 函数为 ACXCIRCUIT 分配一组 KSCATERGORY 条目。
AcxCircuitInitAssignComponentUri AcxCircuitInitAssignComponentUri 函数分配 URI 字符串作为 ACXCIRCUIT 的标识符。
AcxCircuitInitAssignMethods AcxCircuitInitAssignMethods 函数为 ACXCIRCUIT 分配一个或多个 ACX 方法。
AcxCircuitInitAssignName AcxCircuitInitAssignName 函数为 ACXCIRCUIT 分配友好名称。
AcxCircuitInitAssignProperties AcxCircuitInitAssignProperties 函数为 ACXCIRCUIT 分配一个或多个 ACX 属性。
AcxCircuitInitDisableDefaultStreamBridgeHandling AcxCircuitInitDisableDefaultStreamBridgeHandling 函数在多线路环境中禁用 ACX 默认流桥处理。
AcxCircuitInitFree AcxCircuitInitFree 函数删除线路初始化对象。
AcxCircuitInitSetAcxCircuitCompositeCallbacks AcxCircuitInitSetAcxCircuitCompositeCallbacks 函数为 ACXCIRCUIT 设置驱动程序的复合回调。
AcxCircuitInitSetAcxCircuitPnpPowerCallbacks AcxCircuitInitSetAcxCircuitPnpPowerCallbacks 函数为 ACXCIRCUIT 设置驱动程序的 PNP 回调。
AcxCircuitInitSetCircuitType AcxCircuitInitSetCircuitType 函数用于设置 ACXCIRCUIT 的线路类型。
AcxCircuitInitSetComponentId AcxCircuitInitSetComponentId 函数设置 ACXCIRCUIT 的组件 ID。
AcxCircuitResumeIo AcxCircuitResumeIo 函数用于在线路 I/O 暂时停止后恢复线路 I/O。
AcxCircuitResumeIoActual AcxCircuitResumeIoActual 函数用于在线路 I/O 停止后恢复线路 I/O。
AcxCircuitResumeIoWithTag AcxCircuitResumeIoWithTag 函数用于在线路 I/O 停止后恢复线路 I/O。
AcxCircuitStopIo AcxCircuitStopIo 函数用于向操作系统发出信号，以暂时停止线路 I/O。
AcxCircuitStopIoActual AcxCircuitStopIoActual 函数用于向操作系统发出信号，以暂时停止线路 I/O。
AcxCircuitStopIoWithTag AcxCircuitStopIoWithTag 函数用于向操作系统发出信号，以暂时停止线路 I/O。
AcxFactoryCircuitAddElements AcxFactoryCircuitAddElements 函数将元素添加到 ACXFACTORYCIRCUIT。
AcxFactoryCircuitCreate AcxFactoryCircuitCreate 函数用于创建 ACXFACTORYCIRCUIT。
AcxFactoryCircuitGetSymbolicLinkName AcxFactoryCircuitGetSymbolicLinkName 函数检索指定 ACX 工厂线路的符号链接名称。
AcxFactoryCircuitInitAllocate AcxFactoryCircuitInitAllocate 函数用于初始化 AcxFactoryCircuitCreate 函数使用的不透明ACXFACTORYCIRCUIT_INIT结构。
AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback AcxFactoryCircuitInitAssignAcxRequestPreprocessCallback 函数添加 WDFREQUEST 预处理回调。
AcxFactoryCircuitInitAssignCategories AcxFactoryCircuitInitAssignCategories 函数为 ACXFACTORYCIRCUIT 分配一组驱动程序类别 (GUID) 条目。
AcxFactoryCircuitInitAssignComponentUri AcxFactoryCircuitInitAssignComponentUri 函数分配 URI 字符串作为 ACXFACTORYCIRCUIT 的标识符。
AcxFactoryCircuitInitAssignMethods AcxCircuitFactoryInitAssignMethods 函数为 ACXFACTORYCIRCUIT 分配一个或多个 ACX 方法。
AcxFactoryCircuitInitAssignName AcxFactoryCircuitInitAssignName 函数为 ACXFACTORYCIRCUIT 分配友好名称。
AcxFactoryCircuitInitAssignProperties AcxFactoryCircuitInitAssignProperties 函数为 ACXFACTORYCIRCUIT 分配一个或多个 ACX 属性。
AcxFactoryCircuitInitFree AcxFactoryCircuitInitFree 函数删除工厂线路初始化对象。
AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks 函数为 ACXFACTORYCIRCUIT 设置驱动程序的 PNP 回调。
AcxFactoryCircuitInitSetComponentId AcxFactoryCircuitInitSetComponentId 函数设置 ACXFACTORYCIRCUIT 的组件 ID。
AcxFactoryCircuitInitSetOperationCallbacks AcxFactoryCircuitInitSetOperationCallbacks 为 ACXFACTORYCIRCUIT 设置驱动程序工厂操作回调。

回调函数

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 当 ACX 管理器检测到并初始化复合线路时，驱动程序使用EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE回调来执行复合线路的任何初始化。
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE 当 ACX 管理器取消初始化复合线路时，驱动程序使用EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE回调对复合线路执行任何初始化操作。
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE 在 ACX Manager 组装复合终结点后，驱动程序使用EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE回调执行任何初始化后操作。
EVT_ACX_CIRCUIT_CREATE_STREAM 驱动程序定义EVT_ACX_CIRCUIT_CREATE_STREAM回调以创建线路流实例。
EVT_ACX_CIRCUIT_POWER_DOWN 驱动程序使用EVT_ACX_CIRCUIT_POWER_DOWN回调在 ACXCIRCUIT 对象的断电路径中添加功能。
EVT_ACX_CIRCUIT_POWER_UP 驱动程序使用EVT_ACX_CIRCUIT_POWER_UP回调在 ACXCIRCUIT 对象的通电路径中添加功能。
EVT_ACX_CIRCUIT_PREPARE_HARDWARE 当线路处于准备硬件阶段时，驱动程序使用EVT_ACX_CIRCUIT_PREPARE_HARDWARE回调来添加功能。
EVT_ACX_CIRCUIT_RELEASE_HARDWARE 当 ACXCIRCUIT 处于发布硬件阶段时，驱动程序使用EVT_ACX_CIRCUIT_RELEASE_HARDWARE回调来添加功能。
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT 当驱动程序必须使用指定的配置创建 ACXCIRCUIT 对象时，ACX 将调用EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUIT回调。
EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE 当驱动程序必须为新的 ACXCIRCUIT 对象创建 WDFDEVICE 时，ACX 将调用EVT_ACX_FACTORY_CIRCUIT_CREATE_CIRCUITDEVICE回调。
EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 当驱动程序必须删除以前创建的与 ACXCIRCUIT 对象关联的 WDFDEVICE 时，ACX 将调用EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回调。
EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN 驱动程序使用EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN回调在 ACXFACTORYCIRCUIT 对象的电源关闭路径中添加功能。
EVT_ACX_FACTORY_CIRCUIT_POWER_UP 驱动程序使用EVT_ACX_FACTORY_CIRCUIT_POWER_UP回调在 ACXFACTORYCIRCUIT 对象的通电路径中添加功能。
EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE 当线路工厂处于准备硬件阶段时，驱动程序使用EVT_ACX_FACTORY_CIRCUIT_PREPARE_HARDWARE回调来添加功能。
EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE 当 ACXFACTORYCIRCUIT 处于发布硬件阶段时，驱动程序使用EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE回调来添加功能。

结构

ACX_CIRCUIT_COMPOSITE_CALLBACKS ACX_CIRCUIT_COMPOSITE_CALLBACKS 结构标识 ACX 复合线路操作的驱动程序回调。
ACX_CIRCUIT_PNPPOWER_CALLBACKS ACX_CIRCUIT_PNPPOWER_CALLBACKS 结构包含指向 ACXCIRCUIT 的即插即用和电源事件回调函数的指针。
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT ACX_FACTORY_CIRCUIT_ADD_CIRCUIT 结构用于由 ACX 线路工厂添加线路。
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS 结构标识 ACX 工厂操作的驱动程序回调。
ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS ACX_FACTORY_CIRCUIT_PNPPOWER_CALLBACKS 结构包含指向 ACXFACTORYCIRCUIT 即插即用 和电源事件回调函数的指针。
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT 结构用于删除 ACX 线路工厂线路。

枚举

ACX_CIRCUIT_TYPE ACX_CIRCUIT_TYPE 枚举定义 ACXCIRCUIT 的类型。
ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_FLAGS ACX_FACTORY_CIRCUIT_ADD_CIRCUIT_FLAGS 枚举定义工厂线路添加标志。
ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_FLAGS ACX_FACTORY_CIRCUIT_REMOVE_CIRCUIT_FLAGS 枚举定义工厂线路删除标志。
ACX_STOP_IO_FLAGS ACX_STOP_IO_FLAGS 枚举定义停止 IO 标志。