PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE fonction de rappel (ndis.h)
La fonction ProtocolCmNotifyCloseAfComplete indique qu’un client a terminé la fermeture d’une famille d’adresses (AF) qu’un gestionnaire d’appels autonome ou un gestionnaire d’appels miniport (MCM) a démarré en appelant le NdisCmNotifyCloseAddressFamily ou fonction NdisMCmNotifyCloseAddressFamily, respectivement.
Syntaxe
PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE ProtocolCmNotifyCloseAfComplete;
void ProtocolCmNotifyCloseAfComplete(
[in] NDIS_HANDLE CallMgrAfContext,
[in] NDIS_STATUS Status
)
{...}
Paramètres
[in] CallMgrAfContext
Handle de la zone de contexte AF du gestionnaire d’appels fournie à NDIS dans la fonction ProtocolCmOpenAf.
[in] Status
État final des clients pour la notification de fermeture AF. Status peut être l’une des options suivantes :
NDIS_STATUS_SUCCESS
Le client a correctement fermé sa famille d’adresses.
NDIS_STATUS_XXX
Le client a échoué la demande pour une raison déterminée par le pilote.
Valeur de retour
Aucun
Remarques
La fonction ProtocolCmNotifyCloseAfComplete est requise pour les gestionnaires d’appels CoNDIS.
Si un gestionnaire d’appels autonome se dissocie d’un adaptateur miniport sous-jacent, le gestionnaire d’appels doit appeler le NdisCmNotifyCloseAddressFamily fonction avant de dissocier. Lorsqu’un gestionnaire d’appels miniport (MCM) interrompt un adaptateur miniport, le MCM doit appeler le NdisMCmNotifyCloseAddressFamily fonction.
Si NdisCmNotifyCloseAddressFamily ou NdisMCmNotifyCloseAddressFamily retourne NDIS_STATUS_PENDING, NDIS appelle ProtocolCmNotifyCloseAfComplete une fois l’opération de fermeture AF terminée.
NDIS appelle ProtocolCmNotifyCloseAfComplete au <IRQL = DISPATCH_LEVEL.
exemples de
Pour définir une fonction ProtocolCmNotifyCloseAfComplete, 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 ProtocolCmNotifyCloseAfComplete nommée « MyCmNotifyCloseAfComplete », utilisez le type PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE comme indiqué dans cet exemple de code :
PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE MyCmNotifyCloseAfComplete;
Ensuite, implémentez votre fonction comme suit :
_Use_decl_annotations_
VOID
MyCmNotifyCloseAfComplete(
NDIS_HANDLE CallMgrAfContext,
NDIS_STATUS Status
)
{...}
Le type de fonction PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 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 PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE 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 | <= DISPATCH_LEVEL |