AcxPnpEventGenerateEvent, fonction (acxevents.h)

  • Article

La fonction AcxPnpEventGenerateEvent génère un événement ACX PNP.

Syntaxe

NTSTATUS AcxPnpEventGenerateEvent(
  ACXPNPEVENT Event,
  PVOID       Payload,
  USHORT      Size
);

Paramètres

Event

Objet ACXPNPEVENT (décrit dans Résumé des objets ACX).

Payload

Charge utile de l’événement.

Size

Taille de la charge utile de l’événement.

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

La charge utile est spécifique au type d’événement PNP généré.

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, les ACXPNPEVENTs sont exposés en tant que notification asynchrone PNP aux couches supérieures.

Exemple

Cet exemple de capture de code montre l’utilisation d’AcxPnpEventGenerateEvent.

        AUDIOMODULE_CUSTOM_NOTIFICATION customNotification = {0};

        customNotification.Type = AudioModuleParameterChanged;
        customNotification.ParameterChanged.ParameterId = command->ParameterId;

        status = AcxPnpEventGenerateEvent(audioModuleCtx->Event, &customNotification, (USHORT)sizeof(customNotification));

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