acxevents.h 标头

acxevents 标头由 ACX 音频类扩展使用。

ACXEVENT 表示驱动程序级别可用的异步通知。 可以将事件添加到 ACXCIRCUIT、ACXSTREAMs、ACXELEMENTs 和 ACXPIN。 在内部，它们作为 KS 事件公开到上层。

ACXEVENT 可用于各种目的，例如，它们可用于向用户引起的硬件事件发出信号。 某些音频设备提供硬件音量控制旋钮、静音开关或其他类型的手动控件。 应用程序可以通过调整音量或以其他方式更改音频流的播放方式来响应这些控件中的更改。 当用户调整硬件控件时，ACX 会通知驱动程序发生了硬件事件。

有关详细信息，请参阅：

• ACX 音频类扩展概述

• 音频：

音频内核 Steaming KSEVENTS

有关 KSEVENTS 的一般信息，请参阅这些主题。

KS 事件

KSEVENT 结构

KSPROPSETID_Audio

音频设备硬件事件

注意

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

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

函数

ACX_EVENT_CALLBACKS_INIT ACX_EVENT_CALLBACKS_INIT 函数初始化ACX_EVENTS_CALLBACKS结构。
ACX_EVENT_CONFIG_INIT ACX_EVENT_CONFIG_INIT 函数初始化ACX_EVENT_CONFIG结构。
ACX_PNPEVENT_CONFIG_INIT ACX_PNPEVENT_CONFIG_INIT 函数初始化ACX_PNPEVENT_CONFIG结构。
AcxEventAddEventData AcxEventAddEventData 函数将事件数据添加到 ACXEVENT 对象。
AcxEventCreate AcxEventCreate 函数创建事件。
AcxEventGenerateEvent AcxEventGenerateEvent 函数生成事件。
AcxPnpEventCreate AcxPnpEventCreate 函数创建 ACXPNPEVENT。
AcxPnpEventGenerateEvent AcxPnpEventGenerateEvent 函数生成 ACX PNP 事件。

回调函数

EVT_ACX_EVENT_DISABLE 驱动程序使用EVT_ACX_EVENT_DISABLE回调来禁用 ACXEVENT 源。
EVT_ACX_EVENT_ENABLE 驱动程序使用EVT_ACX_EVENT_ENABLE回调来启用 ACXEVENT 源。

结构

ACX_EVENT_CALLBACKS ACX_EVENT_CALLBACKS 结构标识 ACX 事件操作的驱动程序回调。
ACX_EVENT_CONFIG ACX_EVENT_CONFIG 结构用于配置 ACXEVENT。
ACX_PNPEVENT_CONFIG ACX_PNPEVENT_CONFIG 结构用于配置 ACXPNPEVENT。

枚举

ACX_EVENT_CONFIG_FLAGS ACX_EVENT_CONFIG_FLAGS枚举定义 ACXEVENT 类型的 EVENT 配置标志。
ACX_PNPEVENT_CONFIG_FLAGS ACX_PNPEVENT_CONFIG_FLAGS枚举定义 ACXEVENT 类型的 PNPEVENT 配置标志。