AcxPnpEventGenerateEvent-Funktion (acxevents.h)

  • Artikel

Die AcxPnpEventGenerateEvent-Funktion generiert ein ACX-PNP-Ereignis.

Syntax

NTSTATUS AcxPnpEventGenerateEvent(
  ACXPNPEVENT Event,
  PVOID       Payload,
  USHORT      Size
);

Parameter

Event

Das ACXPNPEVENT-Objekt (beschrieben in Zusammenfassung der ACX-Objekte).

Payload

Die Ereignisnutzlast.

Size

Die Größe der Ereignisnutzlast.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Hinweise

Die Nutzlast ist spezifisch für den Typ des generierten PNP-Ereignisses.

Ein ACXPNPEVENT stellt eine asynchrone Benachrichtigung dar, die auf Treiberebene verfügbar ist. PNP-Ereignisse können jedem Objekt hinzugefügt werden. Derzeit werden sie mit ACXAUDIOMODULE- und ACXKEYWARDSPOTTER-Objekten verwendet. Intern werden ACXPNPEVENTs als asynchrone PNP-Benachrichtigung für obere Schichten verfügbar gemacht.

Beispiel

In diesem Codebeispiel wird die Verwendung von AcxPnpEventGenerateEvent veranschaulicht.

        AUDIOMODULE_CUSTOM_NOTIFICATION customNotification = {0};

        customNotification.Type = AudioModuleParameterChanged;
        customNotification.ParameterChanged.ParameterId = command->ParameterId;

        status = AcxPnpEventGenerateEvent(audioModuleCtx->Event, &customNotification, (USHORT)sizeof(customNotification));

ACX-Anforderungen

AcX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxevents.h
IRQL PASSIVE_LEVEL

Weitere Informationen