PROTOCOL_CO_STATUS_EX fonction de rappel (ndis.h)
La fonction ProtocolCoStatusEx indique status modifications des pilotes orientés connexion sous-jacents ou de NDIS.
Syntaxe
PROTOCOL_CO_STATUS_EX ProtocolCoStatusEx;
void ProtocolCoStatusEx(
[in] NDIS_HANDLE ProtocolBindingContext,
[in] NDIS_HANDLE ProtocolVcContext,
[in] PNDIS_STATUS_INDICATION StatusIndication
)
{...}
Paramètres
[in] ProtocolBindingContext
Handle pour une zone de contexte allouée par le pilote de protocole. Le pilote de protocole conserve les informations de contexte par liaison dans cette zone de contexte. Le pilote a fourni ce handle à NDIS quand le pilote a appelé la fonction NdisOpenAdapterEx .
[in] ProtocolVcContext
Handle vers une zone de contexte allouée par le pilote de protocole dans laquelle le pilote de protocole gère les informations d’état d’exécution de la connexion virtuelle (VC). Si l’indication status n’est pas spécifique à VC, ce paramètre a la valeur NULL. Sinon, le pilote de protocole fournissait initialement ce handle soit lorsqu’il a appelé la fonction NdisCoCreateVc , soit à partir de sa fonction ProtocolCoCreateVc .
[in] StatusIndication
Pointeur vers une structure de NDIS_STATUS_INDICATION qui contient les informations status.
Valeur de retour
None
Remarques
NDIS appelle ProtocolCoStatusEx pour informer un pilote de protocole des modifications apportées au status d’un pilote CoNDIS sous-jacent. Un handle VC NULL pour le paramètre ProtocolVcContext indique une modification status qui n’est pas spécifique à un vc. Pour un handle VC non NULL, NDIS limite la notification status aux clients ou aux gestionnaires d’appels qui partagent ce handle VC.
NDIS sérialise status indications pour chaque liaison de protocole. Pour déterminer les status de liaison, utilisez les indications status des pilotes sous-jacents au lieu des requêtes OID. Ces status indications amélioreront les performances du système et éviteront d’éventuelles conditions de concurrence.
NDIS appelle ProtocolCoStatusEx à IRQL <= DISPATCH_LEVEL.
Exemples
Pour définir une fonction ProtocolCoStatusEx , 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, au vérificateur de pilotes statiques (SDV) et à d’autres outils de vérification de trouver des erreurs. 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 ProtocolCoStatusEx nommée « MyCoStatusEx », utilisez le type PROTOCOL_CO_STATUS_EX comme indiqué dans cet exemple de code :
PROTOCOL_CO_STATUS_EX MyCoStatusEx;
Ensuite, implémentez votre fonction comme suit :
_Use_decl_annotations_
VOID
MyCoStatusEx(
NDIS_HANDLE ProtocolBindingContext,
NDIS_HANDLE ProtocolVcContext,
PNDIS_STATUS_INDICATION StatusIndication
)
{...}
Le type de fonction PROTOCOL_CO_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_CO_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 (voir la section Notes) |