NdisInitializeEvent-Funktion (ndis.h)
Die NdisInitializeEvent-Funktion richtet während der Treiberinitialisierung ein Ereignisobjekt ein, das anschließend als Synchronisierungsmechanismus verwendet werden kann.
Syntax
void NdisInitializeEvent(
[out] PNDIS_EVENT Event
);
Parameter
[out] Event
Ein Zeiger auf den vom Aufrufer bereitgestellten Speicher für das Ereignisobjekt, der für Treiber nicht transparent ist.
Rückgabewert
Keine
Bemerkungen
Die NdisInitializeEvent-Funktion erstellt ein Ereignisobjekt, das über den Ereignistyp NotificationEvent und den Anfangszustand nicht signalisiert verfügt. Weitere Informationen zu Benachrichtigungsereignissen finden Sie unter Definieren und Verwenden eines Ereignisobjekts.
Der anNdisInitializeEvent übergebene Ereigniszeiger ist ein erforderlicher Parameter für alle anderen NdisXxx-Ereignisfunktionen.
Treiberfunktionen, die unter IRQL <= DISPATCH_LEVEL ausgeführt werden müssen, können zwar die Funktionen NdisSetEvent und NdisResetEvent aufrufen, aber das Aufrufen von NdisWaitEvent aus einem beliebigen IRQL-PASSIVE_LEVEL > ist ein schwerwiegender Fehler.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisInitializeEvent (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisInitializeEvent (NDIS 5.1)) in Windows XP. |
| Zielplattform | Universell |
| Header | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | Beliebige Ebene |