Partager via


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)

Voir aussi

KeClearEvent

KeInitializeEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject