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) |