FILTER_NET_PNP_EVENT fonction de rappel (ndis.h)

Article
08/07/2023

NDIS appelle la fonction FilterNetPnPEvent d’un pilote de filtre pour notifier le pilote des événements de Plug-and-Play réseau (PnP) et de gestion de l’alimentation.

Note Vous devez déclarer la fonction à l’aide du type FILTER_NET_PNP_EVENT . Pour plus d’informations, consultez la section Exemples suivante.

Syntaxe

FILTER_NET_PNP_EVENT FilterNetPnpEvent;

NDIS_STATUS FilterNetPnpEvent(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
)
{...}

Paramètres

[in] FilterModuleContext

Handle de la zone de contexte du module de filtre. Le pilote de filtre a créé et initialisé cette zone de contexte dans la fonction FilterAttach .

[in] NetPnPEventNotification

Pointeur vers un NET_PNP_EVENT_NOTIFICATION structure, qui décrit l’événement PnP ou l’événement Gestion de l’alimentation indiqué au pilote de filtre.

Valeur retournée

FilterNetPnPEvent peut retourner l’un des éléments suivants :

Code de retour	Description
NDIS_STATUS_SUCCESS	Le pilote a correctement traité l’événement PnP.
NDIS_STATUS_FAILURE	Le pilote a échoué à l’événement PnP.

La valeur de retour est significative uniquement lorsque l’événement propagé est un événement NetEventQueryPower ou NetEventQueryRemove . Pour tous les autres événements propagés, la valeur de retour est toujours NDIS_STATUS_SUCCESS.

Remarques

FilterNetPnPEvent est une fonction facultative. Si un pilote de filtre ne gère pas les événements PnP réseau, il peut définir le point d’entrée de cette fonction sur NULL lorsqu’il appelle le Fonction NdisFRegisterFilterDriver .

FilterNetPnPEvent est similaire à la fonction ProtocolNetPnPEvent d’un pilote de protocole. Un pilote de filtre peut transférer ces notifications à des pilotes trop avancés ou il peut les gérer lui-même et ne pas les transférer. Pour transférer une notification, appelez la fonction NdisFNetPnPEvent . Ne confondez pas cette fonction avec le Fonction FilterDevicePnPEventNotify , qui filtre les notifications qui sont dirigées vers le bas de la pile vers les pilotes sous-jacents.

NDIS appelle FilterNetPnPEvent pour notifier un pilote de filtre d’un événement PnP ou Power Management qui a été émis pour une carte réseau sous-jacente. NDIS appelle la fonction FilterNetPnPEvent de chaque pilote de filtre qui se superpose à une carte réseau, puis appelle la fonction ProtocolNetPnPEvent de chaque pilote de protocole de sur-superposition.

Lorsqu’un module de filtre est inséré ou supprimé d’une pile de pilotes, les caractéristiques de la pile peuvent changer. NDIS envoie un événement PnP à toutes les liaisons de protocole et modules de filtre affectés pour les informer de cette modification. Les pilotes de filtre doivent gérer ces modifications de manière appropriée.

NDIS appelle FilterNetPnPEvent à IRQL = PASSIVE_LEVEL.

Exemples

Pour définir une fonction FilterNetPnPEvent , vous devez d’abord fournir une déclaration de fonction qui identifie le type de fonction que vous définissez. Windows fournit un ensemble de types de fonctions pour les pilotes. La déclaration d’une fonction à l’aide des types de fonction permet à l’analyse du code pour les pilotes, le vérificateur de pilotes statique (SDV) et d’autres outils de vérification de trouver les erreurs, et il s’agit d’une exigence pour l’écriture de pilotes pour le système d’exploitation Windows.

Par exemple, pour définir une fonction FilterNetPnPEvent nommée « MyNetPnPEvent », utilisez le type FILTER_NET_PNP_EVENT comme indiqué dans cet exemple de code :

FILTER_NET_PNP_EVENT MyNetPnPEvent;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
NDIS_STATUS
 MyNetPnPEvent(
    NDIS_HANDLE  FilterModuleContext,
    PNET_PNP_EVENT_NOTIFICATION  NetPnPEvent
    )
  {...}

Le type de fonction FILTER_NET_PNP_EVENT est défini dans le fichier d’en-tête Ndis.h. Pour identifier plus précisément les erreurs lors de l’exécution des outils d’analyse du code, veillez à ajouter l’annotation Use_decl_annotations à votre définition de fonction. L’annotation Use_decl_annotations garantit que les annotations appliquées au type de fonction FILTER_NET_PNP_EVENT dans le fichier d’en-tête sont utilisées. Pour plus d’informations sur la configuration requise pour les déclarations de fonction, consultez Déclaration de fonctions à l’aide de types de rôles de fonction pour les pilotes NDIS.

Pour plus d’informations sur Use_decl_annotations, consultez Annotating Function Behavior.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Windows
En-tête	ndis.h (inclure Ndis.h)
IRQL	PASSIVE_LEVEL