IKsControl ::KsEvent, méthode (ks.h)
La méthode IKsControl ::KsEvent active ou désactive un événement, ainsi que les autres opérations de support définies disponibles sur un jeu 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 à 'é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 des données pour l’événement.
DataLength
Spécifie la taille, en octets, de la mémoire tampon à EventData.
BytesReturned
Pointeur vers une variable qui reçoit la taille, en octets, des données qui KsEvent stocke dans la mémoire tampon à EventData.
Valeur de retour
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 au pointeur vers la structure KSEVENTDATA précédemment utilisée pour activer l’événement.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | DesktopMobile |
| d’en-tête | ks.h (include Ks.h) |