KsGenerateDataEvent, fonction (ks.h)
La fonction KsGenerateDataEvent génère l’une des notifications d’événement standard lorsqu’elle reçoit une structure d’entrée d’événement et des données de rappel. Cela permet à un appareil de déterminer quand les notifications d’événements doivent être générées, mais utilisez toujours cette fonction d’assistance pour effectuer la notification réelle.
Syntaxe
KSDDKAPI NTSTATUS KsGenerateDataEvent(
[in] PKSEVENT_ENTRY EventEntry,
[in] ULONG DataSize,
[in] PVOID Data
);
Paramètres
[in] EventEntry
Spécifie la structure d’entrée d’événement qui référence les données d’événement. Les informations sont utilisées pour déterminer le type de notification à effectuer. Si le type de notification n’est pas l’une des normes prédéfinies, une erreur est retournée. Dans le cas d’un événement unique et non récupérant, cette entrée n’est pas valide lorsqu’elle est retournée par la fonction. Par conséquent, tout code qui énumère une liste d’événements doit préincréer pour acquérir l’événement suivant dans la liste avant de passer cet événement à la fonction.
[in] DataSize
Spécifie la taille en octets du paramètre data passé.
[in] Data
Pointe vers les données à passer au rappel client. Ces données sont copiées dans l’un des emplacements de mémoire tampon prélocalisés configurés lorsque l’événement a été activé. La taille des données doit être inférieure à ce qui a été alloué à l’origine ou l’événement échouera.
Valeur de retour
La fonction KsGenerateDataEvent retourne STATUS_SUCCESS si elle réussit, ou si elle échoue, elle renvoie une exception ou une erreur de mémoire.
Remarques
Il est supposé que le verrou de liste d’événements a été acquis avant que cette fonction soit appelée. Cette fonction peut entraîner un appel à l'RemoveHandler pour l’entrée d’événement. Par conséquent, la fonction ne doit pas être appelée à un niveau supérieur au niveau IRQ du verrou, ou la fonction Supprimer doit être en mesure de gérer l’appel à un tel niveau IRQ.
Cette fonction est spécifiquement destinée aux événements qui transmettent des données via un rappel à un client.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |