IKsControl ::KsEvent, méthode (ksproxy.h)
La méthode 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
HRESULT KsEvent(
[in, optional] PKSEVENT Event,
[in] ULONG EventLength,
[in, out] LPVOID EventData,
[in] ULONG DataLength,
[in, out] ULONG *BytesReturned
);
Paramètres
[in, optional] 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.
[in] EventLength
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é.
[in, out] 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.
[in] DataLength
Taille, en octets, de la mémoire tampon à EventData.
[in, out] 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
Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur. Si l’appel réussit, l’événement se trouve dans la liste des événements du pilote.
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.
Le paramètre EventData de IKsControl ::KsEvent contient un handle dans EventHandle.Event. Vous pouvez attendre que le handle devienne disponible et recevoir des notifications lorsque le minidriver appelle KsXxxGenerateEvents ou StreamClassStreamNotification.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | DesktopMobile |
| d’en-tête | ksproxy.h (include Ksproxy.h) |