Freigeben über


NdisWaitEvent-Funktion (ndis.h)

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)

Weitere Informationen

DriverEntry of NDIS Protocol Drivers

MiniportHaltEx

MiniportInitializeEx

NdisInitializeEvent

NdisResetEvent

NdisSetEvent

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx