Méthode IKsControl ::KsEvent (ks.h)
La méthode IKsControl ::KsEvent active ou désactive un événement, ainsi que toutes les autres opérations de prise en charge définies disponibles sur un ensemble d’événements.
Syntaxe
NTSTATUS KsEvent(
PKSEVENT Event,
ULONG EventLength,
PVOID EventData,
ULONG DataLength,
ULONG *BytesReturned
);
Paramètres
Event
Pointeur vers une structure KSEVENT qui décrit un événement pour activer l’événement et NULL pour désactiver l’événement.
EventLength
Spécifie la taille, en octets, de la mémoire tampon sur Événement lorsque l’événement est activé et zéro lorsque l’événement est désactivé.
EventData
Pointeur vers une structure KSEVENTDATA qui contient des données pour l’événement et l’espace tampon qui reçoit les données de l’événement.
DataLength
Spécifie la taille, en octets, de la mémoire tampon dans EventData.
BytesReturned
Pointeur vers une variable qui reçoit la taille, en octets, des données que KsEvent stocke dans la mémoire tampon sur EventData.
Valeur retournée
La méthode IKsControl ::KsEvent retourne la même valeur que celle qui serait retournée si l’événement avait été envoyé par IOCTL.
Remarques
Pour désactiver un événement, définissez Event sur NULL, EventLength sur zéro et EventData sur le pointeur vers la structure KSEVENTDATA qui était précédemment utilisée pour activer l’événement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | DesktopMobile |
| En-tête | ks.h (inclure Ks.h) |