acxevents.h header
The acxevents header is used by the ACX audio class extensions.
An ACXEVENT represents an asynchronous notification available at the driver level. Events can be added to ACXCIRCUITs, ACXSTREAMs, ACXELEMENTs and ACXPINs. Internally, they are exposed as KS events to upper layers.
ACXEVENTs can be used for a variety of purposes, for example they can be used to signal user caused hardware events. Some audio devices provide hardware volume-control knobs, mute switches, or other types of manual controls. Applications can respond to changes in these controls by adjusting the volume or otherwise changing the way that the audio stream is played. When the user adjusts a hardware control, ACX informs the driver that a hardware event has occurred.
For more information, see:
Audio Kernel Steaming KSEVENTS
For general information on KSEVENTS, see these topics.
Note
The ACX headers and libraries are not included in the WDK 10.0.22621.2428 (released October 24, 2023), but are available in previous versions, as well as the latest (25000 series builds) Insider Preview of the WDK. For more information about preview versions of the WDK, see Installing preview versions of the Windows Driver Kit (WDK).
acxevents.h contains the following programming interfaces:
Functions
| ACX_EVENT_CALLBACKS_INIT The ACX_EVENT_CALLBACKS_INIT function initializes a ACX_EVENTS_CALLBACKS structure. |
| ACX_EVENT_CONFIG_INIT The ACX_EVENT_CONFIG_INIT function initializes an ACX_EVENT_CONFIG structure. |
| ACX_PNPEVENT_CONFIG_INIT The ACX_PNPEVENT_CONFIG_INIT function initializes an ACX_PNPEVENT_CONFIG structure. |
| AcxEventAddEventData The AcxEventAddEventData function adds event data to an ACXEVENT object. |
| AcxEventCreate The AcxEventCreate function creates an event. |
| AcxEventGenerateEvent The AcxEventGenerateEvent function generates an event. |
| AcxPnpEventCreate The AcxPnpEventCreate function creates an ACXPNPEVENT. |
| AcxPnpEventGenerateEvent The AcxPnpEventGenerateEvent function generates an ACX PNP event. |
Callback functions
| EVT_ACX_EVENT_DISABLE The EVT_ACX_EVENT_DISABLE callback is used by the driver to disable the ACXEVENT source. |
| EVT_ACX_EVENT_ENABLE The EVT_ACX_EVENT_ENABLE callback is used by the driver to enabled the ACXEVENT source. |
Structures
| ACX_EVENT_CALLBACKS The ACX_EVENT_CALLBACKS structure identifies the driver callbacks for ACX event operations. |
| ACX_EVENT_CONFIG The ACX_EVENT_CONFIG structure is used to configure an ACXEVENT. |
| ACX_PNPEVENT_CONFIG The ACX_PNPEVENT_CONFIG structure is used to configure an ACXPNPEVENT. |
Enumerations
| ACX_EVENT_CONFIG_FLAGS The ACX_EVENT_CONFIG_FLAGS enumeration defines the EVENT config flags for an ACXEVENT type. |
| ACX_PNPEVENT_CONFIG_FLAGS The ACX_PNPEVENT_CONFIG_FLAGS enumeration defines the PNPEVENT config flags for an ACXEVENT type. |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for