acxstreams.h 标头

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

有关详细信息，请参阅：

• ACX 音频类扩展概述

• 音频：

注意

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

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

函数

ACX_RT_STREAM_CALLBACKS_INIT ACX_RT_STREAM_CALLBACKS_INIT 函数方法初始化 ACX RT 流回调。 此函数位于 acxstreams 标头中。
ACX_RTPACKET_INIT ACX_RTPACKET_INIT初始化 ACX RT 数据包结构。 此函数位于 acxstreams 标头中。
ACX_STREAM_BRIDGE_CONFIG_INIT ACX_STREAM_BRIDGE_CONFIG_INIT 函数初始化 ACX 流网桥配置结构。
ACX_STREAM_CALLBACKS_INIT ACX_STREAM_CALLBACKS_INIT 函数初始化 ACX 流回调。
AcxDrmAddContentHandlers AcxDrmAddContentHandlers 函数为系统提供处理受保护内容的函数列表。
AcxDrmCreateContentMixed AcxCreateContentMixed 函数创建一个 DRM 内容 ID，用于标识包含来自多个流的混合内容的 ACX 音频流
AcxDrmDestroyContent AcxDrmDestroyContent 函数删除由 AcxDrmCreateContentMixed 创建的 DRM 内容 ID。
AcxDrmForwardContentToDeviceObject AcxDrmForwardContentToDeviceObject 函数接受表示调用方打算将受保护内容转发到的设备的设备对象。
AcxDrmRetrieveContentRights AcxDrmRetrieveContentRights 函数获取分配给 DRM 内容 ID 的 DRM 内容权限。
AcxRtStreamCreate AcxRtStreamCreate 创建一个基于 ACX RT 的Stream，OS 使用该Stream流式传输音频数据。
AcxRtStreamNotifyPacketComplete 数据包完成后，驱动程序调用 AcxRtStreamNotifyPacketComplete。
AcxStreamAddConnections AcxStreamAddConnections 函数在 EvtAcxCircuitCreateStream 期间将显式连接添加到新的 ACX 流
AcxStreamAddElements AcxStreamAddElements 用于将流元素添加到 AcxStream。
AcxStreamAddEvents AcxStreamAddEvents 使用 ACXEVENT 对象将事件添加到流中。
AcxStreamBridgeAddStream AcxStreamBridgeAddStream 函数将现有流添加到现有网桥。 此函数位于 acxstream 标头中。
AcxStreamBridgeCreate AcxStreamBridgeCreate 函数使用流配置为线路创建 StreamBridge。
AcxStreamBridgeGetTargetStream AcxStreamBridgeGetTargetStream 函数获取与特定 ACXSTREAMBRIDGE 对象关联的流。
AcxStreamBridgeRemoveStream AcxStreamBridgeRemoveStream 函数从关联的 ACXSTREAMBRIDGE 对象中删除指定的流。
AcxStreamCreate AcxStreamCreate 创建用于控制流式处理行为的 ACX Stream。
AcxStreamDispatchAcxRequest AcxStreamDispatchAcxRequest 使用 WDFREQUEST 框架请求对象调度 ACX 请求。
AcxStreamGetCircuit AcxStreamGetCircuit 函数返回与流关联的 ACXCIRCUIT 对象。
AcxStreamGetElementById AcxStreamGetElementById 函数返回所请求元素 ID 的 ACXELEMENT 对象句柄。
AcxStreamGetElementsCount AcxStreamGetElementsCount 函数检索指定音频流的元素数。
AcxStreamGetNotificationId AcxStreamGetNotificationId 函数检索指定音频流的即插即用通知 ID。
AcxStreamInitAssignAcxRequestPreprocessCallback AcxStreamInitAssignAcxRequestPreprocessCallback 函数将 AcxRequestPreprocessCallback 分配给流。
AcxStreamInitAssignAcxRtStreamCallbacks AcxStreamInitAssignAcxRtStreamCallbacks 函数使用 ACXSTREAM_INIT 对象设置 RT 回调。
AcxStreamInitAssignAcxStreamCallbacks AcxStreamInitAssignAcxStreamCallbacks 函数使用 ACX_STREAM_CALLBACKS 结构和 ACXSTREAM_INIT 对象设置回调。
AcxStreamInitAssignMethods AcxStreamInitAssignMethods 函数使用 ACXSTREAM_INIT 对象将方法数组分配给流。
AcxStreamInitAssignProperties AcxStreamInitAssignProperties 函数使用 ACXSTREAM_INIT 对象将属性数组分配给流。
AcxStreamInitSetAcxRtStreamSupportsNotifications AcxStreamInitSetAcxRtStreamSupportsNotifications 函数用于指示支持缓冲区通知。
AcxStreamResumeIo AcxStreamResumeIo 函数用于恢复流的 IO。
AcxStreamResumeIoActual AcxStreamResumeIoActual 函数用于恢复流的 IO。
AcxStreamResumeIoWithTag AcxStreamResumeIoWithTag 函数用于恢复流的 IO。
AcxStreamStopIo AcxStreamStopIo 函数用于暂时停止流的 IO。
AcxStreamStopIoActual AcxStreamStopIoActual 函数用于暂时停止流的 IO。
AcxStreamStopIoWithTag AcxStreamStopIoWithTag 函数用于暂时停止流的 IO。
DEFINE_ACXDRMRIGHTS_DEFAULT 此宏提供默认 DRM 权限

回调函数

EVT_ACX_STREAM_ALLOCATE_RTPACKETS EvtAcxStreamAllocateRtPackets 事件告知驱动程序分配 RtPackets 进行流式处理。
EVT_ACX_STREAM_ASSIGN_DRM_CONTENT_ID EVT_ACX_STREAM_ASSIGN_DRM_CONTENT_ID 事件告知驱动程序分配内容 ID 以用于 DRM 流式处理。
EVT_ACX_STREAM_FREE_RTPACKETS EvtAcxStreamFreeRtPackets 事件告知驱动程序释放在之前调用 EvtAcxStreamAllocateRtPackets 时分配的 RtPackets。
EVT_ACX_STREAM_GET_CAPTURE_PACKET EvtAcxStreamGetCapturePacket 告知驱动程序指示最近完全填充 (基于 0 的) 的数据包，包括驱动程序开始填充数据包时的 QPC 值。
EVT_ACX_STREAM_GET_CURRENT_PACKET EvtAcxStreamGetCurrentPacket 告知驱动程序指示哪些数据包 (基于 0 的) 当前正在呈现给硬件，或者当前正由捕获硬件填充。
EVT_ACX_STREAM_GET_HW_LATENCY EvtAcxStreamGetHwLatency 事件告知驱动程序为此流的特定线路提供流延迟， (总体延迟将是不同线路) 延迟的总和。
EVT_ACX_STREAM_GET_PRESENTATION_POSITION EvtAcxStreamGetPresentationPosition 告知驱动程序在计算当前位置时指示当前位置以及 QPC 值。
EVT_ACX_STREAM_PAUSE EvtAcxStreamPause 事件告知驱动程序将流状态从“运行”转换为“暂停”。
EVT_ACX_STREAM_PREPARE_HARDWARE EvtAcxStreamPrepareHardware 事件告知驱动程序准备硬件进行流式处理。
EVT_ACX_STREAM_RELEASE_HARDWARE EvtAcxStreamReleaseHardware 事件告知驱动程序释放为流分配的任何硬件，并将流置于停止状态。
EVT_ACX_STREAM_RUN EvtAcxStreamRun 事件告知驱动程序将流状态从“暂停”转换为“运行”。
EVT_ACX_STREAM_SET_RENDER_PACKET EvtAcxStreamSetRenderPacket 事件告诉驱动程序客户端刚刚释放的数据包。

结构

ACX_RT_STREAM_CALLBACKS ACX_RT_STREAM_CALLBACKS 结构定义 RT 流式传输到 ACX 框架的回调。
ACX_RTPACKET ACX_RTPACKET结构表示单个分配的数据包。 PacketBuffer 必须是 MDL。
ACX_STREAM_BRIDGE_CONFIG AcxStreamBridge 结构由线路流段用于在终结点线路流段之间传播流创建、状态转换和 DRM 设置。
ACX_STREAM_CALLBACKS ACX_STREAM_CALLBACKS 结构标识要流式传输到 ACX 框架的驱动程序回调。
ACXDRMFORWARD ACXDRMFORWARD 结构包含 DRM 系统驱动程序将 DRM 内容 ID 转发到处理受保护内容的设备所需的信息。
ACXDRMRIGHTS ACXDRMRIGHTS 结构指定分配给 ACX 音频引脚或驱动程序流对象的 DRM 内容权限。

枚举

ACX_STREAM_BRIDGE_CONFIG_FLAGS ACX_STREAM_BRIDGE_CONFIG_FLAGS枚举描述 Acx Stream Bridge 配置标志。
ACX_STREAM_BRIDGE_TYPE ACX_STREAM_BRIDGE_TYPE 枚举描述 Acx Stream 网桥类型。
ACX_STREAM_STATE ACX_STREAM_STATE介绍了 Acx Stream State 标志。 此函数位于 acxstreams 标头中。