NdisWaitEvent, fonction (ndis.h)

Article
02/27/2024

La fonction NdisWaitEvent place l’appelant dans un état d’attente jusqu’à ce que l’événement donné soit défini sur l’état Signaled ou que l’attente expire.

Syntaxe

BOOLEAN NdisWaitEvent(
  [in] PNDIS_EVENT Event,
  [in] UINT        MsToWait
);

Paramètres

[in] Event

Pointeur vers un objet d’événement initialisé pour lequel l’appelant fournit le stockage.

[in] MsToWait

Nombre de millisecondes d’attente de l’appelant si l’événement n’est pas défini sur l’état signalé dans cet intervalle. La valeur zéro spécifie que l’appelant attend l’événement indéfiniment.

Valeur retournée

NdisWaitEvent retourne TRUE si l’événement est à l’état signalé lorsque l’attente est satisfaite.

Remarques

NdisWaitEvent retourne le contrôle à son appelant lorsque l’événement donné est signalé ou que l’intervalle MsToWait spécifié expire, selon ce qui est le plus tôt possible. Si l’événement est actuellement à l’état signalé lorsque cet appel se produit, NdisWaitEvent retourne le contrôle immédiatement.

Un pilote miniport appelle généralement NdisWaitEvent à partir de ses fonctions MiniportInitializeEx et MiniportHaltEx . Un pilote de protocole appelle généralement NdisWaitEvent à partir de son ProtocoleBindAdapterEx et Fonctions ProtocolUnbindAdapterEx .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisWaitEvent (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisWaitEvent (NDIS 5.1)) dans Windows XP.
Plateforme cible	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)