PROTOCOL_STATUS_EX fonction de rappel (ndis.h)

Article
02/29/2024

La fonction ProtocolStatusEx indique status-modifications des pilotes sans connexion sous-jacents ou NDIS.

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

Syntaxe

PROTOCOL_STATUS_EX ProtocolStatusEx;

void ProtocolStatusEx(
  [in] NDIS_HANDLE ProtocolBindingContext,
  [in] PNDIS_STATUS_INDICATION StatusIndication
)
{...}

Paramètres

[in] ProtocolBindingContext

Handle à une zone de contexte que le pilote de protocole a allouée. Le pilote de protocole conserve les informations de contexte par liaison dans cette zone de contexte. Le pilote a fourni ce handle à NDIS lorsque le pilote a appelé la fonction NdisOpenAdapterEx .

[in] StatusIndication

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

Valeur de retour

None

Remarques

Un appel à ProtocolStatusEx avertit le pilote de protocole des modifications apportées à status d’un pilote sous-jacent.

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.

NDIS appelle la fonction ProtocolStatusEx de tous les pilotes de protocole liés lorsqu’un pilote sous-jacent réinitialise une carte réseau. Tout d’abord, NDIS spécifie le code NDIS_STATUS_RESET_START et, ultérieurement, une fois l’opération de réinitialisation terminée, NDIS spécifie le code NDIS_STATUS_RESET_END .

NDIS n’accepte pas les demandes d’envoi et les demandes OID pour un adaptateur miniport lorsqu’une opération de réinitialisation est en cours. La notification NDIS_STATUS_RESET_START avertit les pilotes de protocole liés d’arrêter ces requêtes sur la liaison affectée jusqu’à ce qu’ils reçoivent la notification NDIS_STATUS_RESET_END correspondante.

NDIS appelle ProtocolStatusEx à IRQL <= DISPATCH_LEVEL.

Exemples

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

PROTOCOL_STATUS_EX MyStatusEx;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
VOID
 MyStatusEx(
    NDIS_HANDLE  ProtocolBindingContext,
    PNDIS_STATUS_INDICATION  StatusIndication
    )
  {...}

Le type de fonction PROTOCOL_STATUS_EX 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 PROTOCOL_STATUS_EX 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