KsGenerateEvent, fonction (ks.h)
La fonction KsGenerateEvent génère une notification d’événement standard en fonction d’une structure d’entrée d’événement.
Syntaxe
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
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 ne fait pas partie des normes prédéfinies, une erreur est retournée. Dans le cas d’un événement unique et non récurrent, cette entrée n’est pas valide lors du retour à partir de la fonction. Par conséquent, tout code énumérant 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.
Valeur retournée
La fonction KsGenerateEvent retourne STATUS_SUCCESS en cas de réussite, ou si elle a échoué, elle retourne une exception ou une erreur de mémoire.
Remarques
Un appareil détermine quand les notifications d’événements sont générées à l’aide de la structure KSEVENT_ENTRY , puis utilise cette fonction pour effectuer la notification réelle. KsGenerateEvent peut être appelé à n’importe quel IRQL. Si elle est appelée ci-dessus DISPATCH_LEVEL, la signalisation de l’événement est effectuée de manière asynchrone dans un DPC.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |
| IRQL | N’importe quel niveau (voir la section Remarques) |