acxevents.h-Header

Der acxevents-Header wird von den ACX-Audioklassenerweiterungen verwendet.

Ein ACXEVENT stellt eine asynchrone Benachrichtigung dar, die auf Treiberebene verfügbar ist. Ereignisse können ACXCIRCUITs, ACXSTREAMs, ACXELEMENTs und ACXPINs hinzugefügt werden. Intern werden sie als KS-Ereignisse für obere Schichten verfügbar gemacht.

ACXEVENTs können für eine Vielzahl von Zwecken verwendet werden, z. B. zur Signalisierung von Hardwareereignissen durch den Benutzer. Einige Audiogeräte bieten Hardware-Lautstärkeregler, Stummschaltschalter oder andere Arten manueller Steuerelemente. Anwendungen können auf Änderungen in diesen Steuerelementen reagieren, indem sie die Lautstärke anpassen oder die Wiedergabe des Audiodatenstroms auf andere Weise ändern. Wenn der Benutzer ein Hardwaresteuerelement anpasst, informiert ACX den Treiber darüber, dass ein Hardwareereignis aufgetreten ist.

Weitere Informationen finden Sie unter

• ACX-Audioklassenerweiterungen – Übersicht

• Audio

Audio Kernel Steaming KSEVENTS

Allgemeine Informationen zu KSEVENTS finden Sie in diesen Themen.

KS-Ereignisse

KSEVENT-Struktur

KSPROPSETID_Audio

Hardwareereignisse für Audiogeräte

Hinweis

Die ACX-Header und -Bibliotheken sind nicht im WDK 10.0.22621.2428 (veröffentlicht am 24. Oktober 2023) enthalten, sondern sind in früheren Versionen sowie in den neuesten Insider Preview-Versionen des WDK verfügbar. Weitere Informationen zu Vorschauversionen des WDK finden Sie unter Installieren von Vorschauversionen des Windows Driver Kit (WDK).

acxevents.h enthält die folgenden Programmierschnittstellen:

Functions

ACX_EVENT_CALLBACKS_INIT Die ACX_EVENT_CALLBACKS_INIT-Funktion initialisiert eine ACX_EVENTS_CALLBACKS-Struktur.
ACX_EVENT_CONFIG_INIT Die ACX_EVENT_CONFIG_INIT-Funktion initialisiert eine ACX_EVENT_CONFIG-Struktur.
ACX_PNPEVENT_CONFIG_INIT Die ACX_PNPEVENT_CONFIG_INIT-Funktion initialisiert eine ACX_PNPEVENT_CONFIG-Struktur.
AcxEventAddEventData Die AcxEventAddEventData-Funktion fügt einem ACXEVENT-Objekt Ereignisdaten hinzu.
AcxEventCreate Die AcxEventCreate-Funktion erstellt ein Ereignis.
AcxEventGenerateEvent Die AcxEventGenerateEvent-Funktion generiert ein Ereignis.
AcxPnpEventCreate Die AcxPnpEventCreate-Funktion erstellt ein ACXPNPEVENT.
AcxPnpEventGenerateEvent Die AcxPnpEventGenerateEvent-Funktion generiert ein ACX-PNP-Ereignis.

Rückruffunktionen

EVT_ACX_EVENT_DISABLE Der EVT_ACX_EVENT_DISABLE Rückruf wird vom Treiber verwendet, um die ACXEVENT-Quelle zu deaktivieren.
EVT_ACX_EVENT_ENABLE Der EVT_ACX_EVENT_ENABLE Rückruf wird vom Treiber verwendet, um die ACXEVENT-Quelle zu aktivieren.

Strukturen

ACX_EVENT_CALLBACKS Die ACX_EVENT_CALLBACKS-Struktur identifiziert die Treiberrückrufe für ACX-Ereignisvorgänge.
ACX_EVENT_CONFIG Die ACX_EVENT_CONFIG-Struktur wird zum Konfigurieren eines ACXEVENT verwendet.
ACX_PNPEVENT_CONFIG Die ACX_PNPEVENT_CONFIG-Struktur wird verwendet, um ein ACXPNPEVENT zu konfigurieren.

Enumerationen

ACX_EVENT_CONFIG_FLAGS Die ACX_EVENT_CONFIG_FLAGS-Enumeration definiert die EVENT-Konfigurationsflags für einen ACXEVENT-Typ.
ACX_PNPEVENT_CONFIG_FLAGS Die ACX_PNPEVENT_CONFIG_FLAGS-Enumeration definiert die PNPEVENT-Konfigurationsflags für einen ACXEVENT-Typ.