AcxPnpEventCreate, fonction (acxevents.h)

  • Article

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 Résumé des objets framework) associé au nouvel événement.

Object

Objet ACXAUDIOMODULE existant décrit dans Résumé des objets ACX qui seront associés à l’événement.

Attributes

Attributs supplémentaires définis à l’aide d’un WDF_OBJECT_ATTRIBUTES utilisés pour définir les valeurs des différents objets : nettoyage et destruction des rappels, type de contexte et pour spécifier 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 retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

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 sont exposés 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 ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxevents.h
IRQL PASSIVE_LEVEL

Voir aussi