NdisWaitEvent-Funktion (ndis.h)

Artikel
02/29/2024

Die NdisWaitEvent-Funktion versetzt den Aufrufer in einen Wartezustand, bis das angegebene Ereignis auf den Signalzustand festgelegt ist oder das Wartezeitzeitüberschreitung überschritten wird.

Syntax

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

Parameter

[in] Event

Ein Zeiger auf ein initialisiertes Ereignisobjekt, für das der Aufrufer den Speicher bereitstellt.

[in] MsToWait

Die Anzahl von Millisekunden, die der Aufrufer wartet, wenn das Ereignis innerhalb dieses Intervalls nicht auf den signalierten Zustand festgelegt ist. Der Wert 0 (null) gibt an, dass der Aufrufer unbegrenzt auf das Ereignis wartet.

Rückgabewert

NdisWaitEvent gibt TRUE zurück, wenn sich das Ereignis im signalierten Zustand befindet, wenn die Wartezeit erfüllt ist.

Hinweise

NdisWaitEvent gibt die Steuerung an seinen Aufrufer zurück, wenn das angegebene Ereignis signalisiert wird oder das angegebene MsToWait-Intervall abläuft, je nachdem, was früher ist. Wenn sich das Ereignis derzeit im signalierten Zustand befindet, wenn dieser Aufruf erfolgt, gibt NdisWaitEvent sofort die Steuerung zurück.

Ein Miniporttreiber ruft in der Regel NdisWaitEvent über seine Funktionen MiniportInitializeEx und MiniportHaltEx auf. Ein Protokolltreiber ruft in der Regel NdisWaitEvent von seinem ProtocolBindAdapterEx und ProtocolUnbindAdapterEx-Funktionen .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisWaitEvent (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisWaitEvent (NDIS 5.1)) in Windows XP.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)