AcxPnpEventGenerateEvent, fonction (acxevents.h)
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 |