FILTER_DETACH fonction de rappel (ndis.h)

Article
02/07/2025

NDIS appelle la fonction FilterDetach d’un pilote de filtre pour libérer toutes les ressources associées à un module de filtre.

Remarque Vous devez déclarer la fonction à l’aide du type FILTER_DETACH. Pour plus d’informations, consultez la section Exemples suivants.

Syntaxe

FILTER_DETACH FilterDetach;

void FilterDetach(
  [in] NDIS_HANDLE FilterModuleContext
)
{...}

Paramètres

[in] FilterModuleContext

Handle vers la zone de contexte du module de filtre que NDIS supprimera de la pile des pilotes. Le pilote de filtre a créé et initialisé cette zone de contexte dans la fonction FilterAttach.

Valeur de retour

Aucun

Remarques

filterDetach est une fonction requise. NDIS appelle FilterDetach pour supprimer un module de filtre d’une pile de pilotes. NDIS appelle FilterDetach lorsque le module de filtre est à l’état suspendu.

FilterDetach libère les zones de contexte du pilote et d’autres ressources (telles que les pools de mémoires tampons) pour le module de filtre concerné.

Une fois le pilote de filtre retourné par FilterDetach, le module de filtre est dans l’état détaché.

NDIS appelle FilterDetach à IRQL = PASSIVE_LEVEL.

exemples de

Pour définir une fonction FilterDetach, 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 fonctions permet d'Analyse du code pour les pilotes, de vérificateur de pilotes statiques (SDV) et d’autres outils de vérification recherchent des erreurs, et il est nécessaire d’écrire des pilotes pour le système d’exploitation Windows.

Par exemple, pour définir une fonction FilterDetach nommée « MyDetach », utilisez le type FILTER_DETACH comme indiqué dans cet exemple de code :

FILTER_DETACH MyDetach;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
VOID
 MyDetach(
    NDIS_HANDLE  FilterModuleContext
    )
  {...}

Le type de fonction FILTER_DETACH est défini dans le fichier d’en-tête Ndis.h. Pour identifier plus précisément les erreurs lorsque vous exécutez les 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_DETACH 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 annoter le comportement de la fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Windows
d’en-tête	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Voir aussi

FilterAttach

Partager via