NdisWaitEvent-Funktion (ndis.h)
Die NdisWaitEvent--Funktion versetzt den Aufrufer in einen Wartezustand, bis das angegebene Ereignis auf den Signalzustand festgelegt ist oder die Wartezeit ü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 der Millisekunden, die der Aufrufer wartet, wenn das Ereignis nicht auf den signalisiert Zustand innerhalb dieses Intervalls festgelegt ist. Ein Wert von Null gibt an, dass der Aufrufer unbegrenzt auf das Ereignis wartet.
Rückgabewert
NdisWaitEvent- gibt TRUE zurück, wenn das Ereignis im signalisiert Zustand ist, wenn die Wartezeit erfüllt ist.
Bemerkungen
NdisWaitEvent- gibt die Steuerung an den 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 Zustand befindet, wenn dieser Aufruf auftritt, gibt NdisWaitEvent- die Steuerung sofort zurück.
Ein Miniporttreiber ruft in der Regel NdisWaitEvent- aus den funktionen MiniportInitializeEx und MiniportHaltEx auf. Ein Protokolltreiber ruft in der Regel NdisWaitEvent- von seinem ProtocolBindAdapterEx- auf und ProtocolUnbindAdapterEx--Funktionen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |