KeReadStateEvent, fonction (wdm.h)
La routine KeReadStateEvent retourne l’état actuel, signalé ou non signalé, 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 de retour
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, zéro est retourné.
Remarques
Cette routine offre 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 supposez pas que les accès d’un état d’événement par KeReadStateEvent s’excluent mutuellement des accès par routines, tels que KeSetEvent et KeWaitForSingleObject, qui synchronisent leur accès à l’état d’é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 à 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énements, consultez event Objects.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’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) |