NdisFNetPnPEvent-Funktion (ndis.h)
Ein Filtertreiber kann die NdisFNetPnPEvent-Funktion aufrufen, um ein PnP-Ereignis (Network Plug & Play) oder ein Power Management-Ereignis an übergeordnete Treiber weiterzuleiten.
Syntax
NDIS_STATUS NdisFNetPnPEvent(
NDIS_HANDLE NdisFilterHandle,
PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
);
Parameter
NdisFilterHandle
Ein Handle für den Kontextbereich für das Filtermodul. Der Filtertreiber hat diesen Kontextbereich in der FilterAttach-Funktion erstellt und initialisiert.
NetPnPEventNotification
Ein Zeiger auf eine NET_PNP_EVENT_NOTIFICATION Struktur, die das Netzwerk-PnP-Ereignis oder das Power Management-Ereignis beschreibt, das vom Filtertreiber weitergeleitet wird.
Rückgabewert
NdisFNetPnPEvent kann eine der folgenden Aktionen zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
Der überlappende Treiber konnte das PnP-Ereignis verarbeiten. |
|
Der überlappende Treiber ist beim PnP-Ereignis fehlgeschlagen. |
Hinweise
NDIS ruft die FilterNetPnPEvent-Funktion eines Filtertreibers auf, um den Filtertreiber über Netzwerk-PnP- und Energieverwaltungsereignisse zu benachrichtigen.
Filtertreiber können diese Benachrichtigungen an überlastende Treiber weiterleiten. Um eine Anforderung weiterzuleiten, rufen Sie die NdisFNetPnPEvent-Funktion aus FilterNetPnPEvent auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Filter_Driver_Function(ndis) |