acxtargets.h 标头

acxtargets 标头由 ACX 音频类扩展使用。 有关详细信息，请参阅 ACX 音频类扩展概述。

WdfIoTarget 是一种 WDF 抽象，用于促进两个不同堆栈之间的通信。 ACX 使用 WdfIoTarget 促进 ACX 对象、线路、引脚、流、元素和线路工厂之间的通信。

ACX 使用以下 ACX 对象来支持目标之间的通信。 有关详细信息，请参阅 ACX - ACX 对象的摘要。

驱动程序使用 AcxTargetCircuit 与由其他堆栈公开的远程线路进行通信。 AcxTargetCircuit 是使用 WdfIoTarget 实现的。

驱动程序使用 AcxTargetPin 与由其他堆栈公开的远程线路引脚进行通信。 AcxTargetPin 是使用 WdfIoTarget 将消息发送到远程固定实体实现的。

驱动程序使用 AcxTargetStream 与由其他堆栈公开的远程线路的流进行通信。 AcxTargetStream 是使用 WdfIoTarget 实现的，用于创建远程流并更改远程流的状态。

驱动程序使用 AcxTargetElement 与由其他堆栈公开的远程线路的元素进行通信。 AcxTargetElement 是使用 WdfIoTarget 将消息发送到远程元素实体实现的。

驱动程序使用 AcxTargetFactoryCircuit 与远程线路工厂实例通信。 AcxTargetFactoryCircuit 是使用 WdfIoTarget 将消息发送到远程线路工厂实现的。

为了与远程线路交互，上述每个 ACX 类型都支持：

• properties
• 方法
• events

有关详细信息，请参阅：

• ACX 音频类扩展概述

• ACX - ACX 对象摘要

• 音频：

注意

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

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

函数

ACX_TARGET_CIRCUIT_CONFIG_INIT ACX_TARGET_CIRCUIT_CONFIG_INIT 函数初始化 ACX 目标线路配置结构。
ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT ACX_TARGET_FACTORY_CIRCUIT_CONFIG_INIT 函数初始化 ACX 目标工厂线路配置结构。
ACX_TARGET_STREAM_CONFIG_INIT ACX_TARGET_STREAM_CONFIG_INIT 函数初始化 ACX 目标流配置结构。
AcxTargetCircuitCreate AcxTargetCircuitCreate 函数用于创建 ACX 目标线路。
AcxTargetCircuitFormatRequestForMethod AcxTargetCircuitFormatRequestForMethod 将 WDFREQUEST 格式化为要用于指定线路目标的 ACX 方法请求。
AcxTargetCircuitFormatRequestForProperty AcxTargetCircuitFormatRequestForProperty 将 WDFREQUEST 格式化为要用于指定线路目标的 ACX 属性请求。
AcxTargetCircuitGetElementsCount AcxTargetCircuitGetElementsCount 函数返回远程目标上的 ACX 元素计数。
AcxTargetCircuitGetPinsCount AcxTargetCircuitGetPinsCount 函数返回远程目标上的 ACX 引脚计数。
AcxTargetCircuitGetSymbolicLinkName AcxTargetCircuitGetSymbolicLinkName 函数检索指定 ACX 目标线路的符号链接名称。
AcxTargetCircuitGetTargetElement AcxTargetCircuitGetTargetElement 函数（给定有效的元素索引值）将返回关联的 ACXTARGETELEMENT 对象。
AcxTargetCircuitGetTargetPin AcxTargetCircuitGetTargetPin 函数（给定有效的引脚索引值）将返回关联的 ACXTARGETPIN 对象。
AcxTargetCircuitGetWdfIoTarget AcxTargetCircuitGetWdfIoTarget 函数将返回关联的 WDFIOTARGET 对象。
AcxTargetElementFormatRequestForMethod AcxTargetElementFormatRequestForMethod 函数将 WDFREQUEST 格式化为要用于指定元素目标的 ACX 方法请求。
AcxTargetElementFormatRequestForProperty AcxTargetElementFormatRequestForProperty 将 WDFREQUEST 格式化为要用于指定元素目标的 ACX 属性请求。
AcxTargetElementGetId 给定现有 ACXTARGETELEMENT 对象的 AcxTargetElementGetId 返回其相应的 ID 值。
AcxTargetElementGetNameTag AcxTargetElementGetNameTag 给定现有的 ACXTARGETELEMENT 对象，以 GUID 的形式返回其 name-tag。
AcxTargetElementGetType AcxTargetElementGetType 函数给定现有的 ACXTARGETELEMENT 对象，以 GUID 的形式返回其相应的元素类型。
AcxTargetElementGetWdfIoTarget AcxTargetElementGetWdfIoTarget 给定现有的 ACXTARGETELEMENT 对象返回其相应的 WDFIOTARGET 对象。
AcxTargetFactoryCircuitCreate AcxTargetFactoryCircuitCreate 函数返回新的 ACXTARGETFACTORYCIRCUIT ACX 对象的句柄。
AcxTargetFactoryCircuitFormatRequestForMethod AcxTargetFactoryCircuitFormatRequestForMethod 将 WDFREQUEST 格式化为 ACX 方法请求，以用于指定的线路工厂目标。
AcxTargetFactoryCircuitFormatRequestForProperty AcxTargetFactoryCircuitFormatRequestForProperty 将 WDFREQUEST 格式化为 ACX 属性请求，以用于指定的线路工厂目标。
AcxTargetFactoryCircuitGetWdfIoTarget AcxTargetFactoryCircuitGetWdfIoTarget 给定现有的 ACXTARGETFACTORYCIRCUIT 对象返回其相应的 WDFIOTARGET 对象。
AcxTargetPinFlushModeDataFormatListCache AcxTargetPinFlushModeDataFormatListCache 函数刷新指定目标引脚的模式数据格式列表缓存。
AcxTargetPinFormatRequestForMethod AcxTargetPinFormatRequestForMethod 函数将 WDFREQUEST 格式化为 ACX 方法请求，以用于指定的引脚目标。
AcxTargetPinFormatRequestForProperty AcxTargetPinFormatRequestForProperty 将 WDFREQUEST 格式化为要用于指定引脚目标的 ACX 属性请求。
AcxTargetPinGetId 给定现有 ACXTARGETPIN 对象的 AcxTargetPinGetId 将返回其关联的 ID 值。
AcxTargetPinGetWdfIoTarget 给定现有 ACXTARGETPIN 对象的 AcxTargetPinGetWdfIoTarget 函数返回其相应的 WDFIOTARGET 对象。
AcxTargetPinRetrieveModeDataFormatList 给定现有的 ACXTARGETPIN 对象，AcxTargetPinRetrieveModeDataFormatList 函数返回与指定信号处理模式数据格式列表关联的 ACXDATAFORMATLIST。
AcxTargetStreamAssignDrmContentId AcxTargetStreamAssignDrmContentId 函数给定现有的 ACXTARGETSTREAM 对象，将 DRM 内容 ID 分配给该流。
AcxTargetStreamCreate AcxTargetStreamCreate 函数用于创建目标流。
AcxTargetStreamFormatRequestForMethod AcxTargetStreamFormatRequestForMethod 将 WDFREQUEST 格式化为要用于指定流目标的 ACX 方法请求。
AcxTargetStreamFormatRequestForProperty AcxTargetStreamFormatRequestForProperty 将 WDFREQUEST 格式化为要用于指定流目标的 ACX 属性请求。
AcxTargetStreamGetElementsCount 给定 ACXTARGETSTREAM 对象的 AcxTargetStreamGetElementsCount 函数返回其 ACX 元素数。
AcxTargetStreamGetTargetElement AcxTargetStreamGetTargetElement 函数（给定有效的元素索引值）返回与指定流关联的相应 ACXTARGETELEMENT ACX 对象。
AcxTargetStreamGetWdfIoTarget AcxTargetStreamGetWdfIoTarget 函数返回与指定流关联的 WDFIOTARGET WDF 对象。

结构

ACX_TARGET_CIRCUIT_CONFIG ACX_TARGET_CIRCUIT_CONFIG结构用于定义目标线路配置。
ACX_TARGET_FACTORY_CIRCUIT_CONFIG ACX_TARGET_FACTORY_CIRCUIT_CONFIG结构用于定义目标工厂线路配置。
ACX_TARGET_STREAM_CONFIG ACX_TARGET_STREAM_CONFIG 结构用于定义目标流配置。

枚举

ACX_TARGET_CIRCUIT_CONFIG_FLAGS ACX_TARGET_CIRCUIT_CONFIG_FLAGS 枚举定义 ACX 目标线路的配置标志。
ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS ACX_TARGET_FACTORY_CIRCUIT_CONFIG_FLAGS 枚举定义 ACX 目标线路工厂的配置标志。
ACX_TARGET_STREAM_CONFIG_FLAGS ACX_TARGET_STREAM_CONFIG_FLAGS 枚举定义 ACX 目标流的配置标志。