AcxPnpEventGenerateEvent-Funktion (acxevents.h)
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 |