Funzione AcxPnpEventCreate (acxevents.h)
La funzione AcxPnpEventCreate crea un 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 Summary of Framework Objects) associato al nuovo evento.
Object
Oggetto ACXAUDIOMODULE esistente descritto in Riepilogo degli oggetti ACX che verranno associati all'evento.
Attributes
Attributi aggiuntivi definiti usando un WDF_OBJECT_ATTRIBUTES utilizzati per impostare i valori dei vari oggetti: pulizia ed eliminazione definitiva di 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 dei valori NTSTATUS.
Commenti
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 mostra 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 di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxevents.h |
| IRQL | PASSIVE_LEVEL |