KeReadStateEvent, fonction (wdm.h)
La routine KeReadStateEvent retourne l’état actuel, signalé ou non, d’un objet d’événement.
Syntaxe
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
Paramètres
[in] Event
Pointeur vers un objet d’événement initialisé pour lequel l’appelant fournit le stockage.
Valeur retournée
Si l’objet d’événement est actuellement défini sur un état signalé, une valeur différente de zéro est retournée. Sinon, la valeur zéro est renvoyée.
Remarques
Cette routine fournit un moyen efficace d’interroger l’état du signal d’un événement. KeReadStateEvent lit l’état de l’événement sans synchroniser son accès à l’événement. Ne partez pas du principe que les accès d’un état d’événement par KeReadStateEvent s’excluent mutuellement des accès des routines, telles que KeSetEvent et KeWaitForSingleObject, qui synchronisent leur accès à l’état de l’événement.
Il est également possible de lire l’état d’un événement à partir de la routine de service d’interruption d’un pilote dans DIRQL, si les conditions suivantes sont remplies : l’objet d’événement du pilote est résident (probablement dans son extension de périphérique) et toute autre fonction qui accède à l’événement synchronise son accès avec l’ISR.
Pour plus d’informations sur les objets d’événement, consultez Objets d’événement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Ntddk.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm) |