FILTER_STATUS fonction de rappel (ndis.h)

  • Article

La fonction FilterStatus indique status modifications signalées par NDIS ou un pilote sous-jacent.

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

Syntaxe

FILTER_STATUS FilterStatus;

void FilterStatus(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNDIS_STATUS_INDICATION StatusIndication
)
{...}

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] StatusIndication

Pointeur vers une structure de NDIS_STATUS_INDICATION qui contient les informations status.

Valeur de retour

None

Remarques

FilterStatus est une fonction facultative. Si un pilote de filtre n’utilise pas status indications, il peut définir le point d’entrée de cette fonction sur NULL lorsqu’il appelle le Fonction NdisFRegisterFilterDriver .

Pour déterminer les status de liaison, utilisez les indications status des pilotes sous-jacents au lieu des requêtes OID. Ces status indications permettront d’améliorer les performances du système et d’éviter d’éventuelles conditions de course.

Un pilote de filtre appelle généralement la fonction NdisFIndicateStatus à la fin de sa fonction FilterStatus pour transmettre l’indication status aux pilotes trop hauts.

Un pilote de filtre peut filtrer certaines indications status ou modifier les status indiqués. Pour filtrer une indication status, le pilote n’appelle simplement pas NdisFIndicateStatus.

NDIS appelle FilterStatus à IRQL <= DISPATCH_LEVEL.

Exemples

Pour définir une fonction FilterStatus , 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 FilterStatus nommée « MyStatus », utilisez le type FILTER_STATUS comme indiqué dans cet exemple de code :

FILTER_STATUS MyStatus;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
VOID
 MyStatus(
    NDIS_HANDLE  FilterModuleContext,
    PNDIS_STATUS_INDICATION  StatusIndication
    )
  {...}

Le type de fonction FILTER_STATUS 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_STATUS 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 <= DISPATCH_LEVEL

Voir aussi

FilterAttach

NDIS_STATUS_INDICATION

NdisFIndicateStatus

NdisFRegisterFilterDriver