KeReadStateEvent, fonction (wdm.h)

Article
02/29/2024

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

KeWaitForSingleObject