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 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érateur, cette entrée n’est pas valide lors du retour de 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.
Valeur de retour
La fonction KsGenerateEvent retourne STATUS_SUCCESS si elle réussit, ou si elle échoue, elle renvoie 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ée à n’importe quel runtime d’intégration. Si elle est appelée ci-dessus DISPATCH_LEVEL, la signalisation de l’événement est effectuée de manière asynchrone dans une DPC.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | N’importe quel niveau (voir la section Remarques) |