AcxPnpEventCreate-Funktion (acxevents.h)
Die AcxPnpEventCreate-Funktion erstellt ein ACXPNPEVENT.
Syntax
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
Parameter
Device
Ein vorhandenes WDFDEVICE-Objekt (beschrieben unter Zusammenfassung der Frameworkobjekte), das dem neuen Ereignis zugeordnet ist.
Object
Ein vorhandenes ACXAUDIOMODULE-Objekt, das unter Zusammenfassung der ACX-Objekte beschrieben wird, die dem Ereignis zugeordnet werden.
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES definiert werden, die zum Festlegen der Werte des verschiedenen Objekts verwendet werden: Bereinigen und Zerstören von Rückrufen, Kontexttyp und angeben des übergeordneten Objekts.
Config
Eine ACX_PNPEVENT_CONFIG-Struktur , die die Konfiguration für ein ACX-PNP-Ereignis definiert.
Event
Das ACXEVENT-Objekt (beschrieben in Zusammenfassung von ACX-Objekten).
Rückgabewert
Gibt zurück STATUS_SUCCESS
, wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Hinweise
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 Ebenen verfügbar gemacht.
Beispiel
In diesem Beispielcode wird die Verwendung von AcxPnpEventCreate veranschaulicht.
NTSTATUS status;
ACXAUDIOMODULE audioModuleElement;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_PNPEVENT_CONFIG audioModuleEventCfg;
ACXPNPEVENT audioModuleEvent;
...
status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);
audioModule0Ctx = GetCodecAudioModule0Context(audioModuleElement);
ACX_PNPEVENT_CONFIG_INIT(&audioModuleEventCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_PNPEVENT_CONTEXT);
attributes.ParentObject = audioModuleElement;
status = AcxPnpEventCreate(Device, audioModuleElement, &attributes, &audioModuleEventCfg, &audioModuleEvent);
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für