AcxPnpEventCreate, fonction (acxevents.h)
La fonction AcxPnpEventCreate crée un ACXPNPEVENT.
Syntaxe
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
Paramètres
Device
Objet WDFDEVICE existant (décrit dans Summary of Framework Objects) associé au nouvel événement.
Object
Objet ACXAUDIOMODULE existant décrit dans Summary of ACX Objects qui sera associé à l’événement.
Attributes
Attributs supplémentaires définis à l’aide d’un WDF_OBJECT_ATTRIBUTES utilisé pour définir les valeurs de l’objet : nettoyage et destruction de rappels, type de contexte et spécification de son objet parent.
Config
Structure ACX_PNPEVENT_CONFIG qui définit la configuration d’un événement ACX PNP.
Event
Objet ACXEVENT (décrit dans Résumé des objets ACX).
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Un ACXPNPEVENT représente une notification asynchrone disponible au niveau du pilote. Les événements PNP peuvent être ajoutés à n’importe quel objet. Actuellement, ils sont utilisés avec les objets ACXAUDIOMODULE et ACXKEYWARDSPOTTER. En interne, AcxPnpEvents est exposé en tant que notification asynchrone PNP aux couches supérieures.
Exemple
Cet exemple de code montre l’utilisation d’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);
Configuration requise pour ACX
version minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxevents.h |
| IRQL | PASSIVE_LEVEL |