Funzione AcxPnpEventCreate (acxevents.h)
La funzione AcxPnpEventCreate crea un oggetto ACXPNPEVENT.
Sintassi
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
Parametri
Device
Oggetto WDFDEVICE esistente (descritto in Riepilogo degli oggetti framework) associato al nuovo evento.
Object
Oggetto ACXAUDIOMODULE esistente descritto in Riepilogo degli oggetti ACX che verrà associato all'evento.
Attributes
Attributi aggiuntivi definiti usando un WDF_OBJECT_ATTRIBUTES utilizzati per impostare i valori dei vari oggetti: pulizia ed eliminazione dei callback, tipo di contesto e per specificare il relativo oggetto padre.
Config
Struttura ACX_PNPEVENT_CONFIG che definisce la configurazione per un evento PNP ACX.
Event
Oggetto ACXEVENT (descritto in Riepilogo degli oggetti ACX).
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso di valori NTSTATUS.
Osservazioni
AcXPNPEVENT rappresenta una notifica asincrona disponibile a livello di driver. Gli eventi PNP possono essere aggiunti a qualsiasi oggetto. Attualmente vengono usati con oggetti ACXAUDIOMODULE e ACXKEYWARDSPOTTER. Gli eventi AcxPnpEvent vengono esposti internamente come notifica asincrona PNP ai livelli superiori.
Esempio
Questo codice di esempio illustra l'uso di AcxPnpEventCreate.
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);
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxevents.h |
| IRQL | PASSIVE_LEVEL |