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 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
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. Les ACXPNPEVENTs sont exposés en interne en tant que notification asynchrone PNP aux couches supérieures.
Exemple
Cet exemple de code snip 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 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 |