MINIPORT_CO_DELETE_VC fonction de rappel (ndis.h)

Article
02/26/2024

La fonction MiniportCoDeleteVc est requise pour les miniports orientés connexion. MiniportCoDeleteVc indique qu’un vc est détruit et supprimé par NDIS.

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

Syntaxe

MINIPORT_CO_DELETE_VC MiniportCoDeleteVc;

NDIS_STATUS MiniportCoDeleteVc(
  [in] NDIS_HANDLE MiniportVcContext
)
{...}

Paramètres

[in] MiniportVcContext

Spécifie le handle d’une zone de contexte allouée par le pilote miniport dans laquelle le pilote miniport conserve son état par vc. Le pilote miniport a fourni ce handle à NDIS à partir de sa fonction MiniportCoCreateVc .

Valeur retournée

Code de retour	Description
NDIS_STATUS_SUCCESS	Indique que le pilote miniport a libéré avec succès toutes les ressources allouées pour ce vc.

Remarques

MiniportCoDeleteVc doit être écrit en tant que fonction synchrone et ne peut, en aucun cas, retourner NDIS_STATUS_PENDING sans provoquer une défaillance à l’échelle du système.

MiniportCoDeleteVc libère toutes les ressources allouées par vc et stockées dans la zone de contexte MiniportVcContext . Le pilote miniport doit également libérer le MiniportVcContext alloué dans sa fonction MiniportCoCreateVc .

Exemples

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

MINIPORT_CO_DELETE_VC MyCoDeleteVc;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  MiniportVcContext
    )
  {...}

Le type de fonction MINIPORT_CO_DELETE_VC 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 MINIPORT_CO_DELETE_VC 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 pour les pilotes NDIS 6.0 et NDIS 5.1 (voir MiniportCoDeleteVc (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir MiniportCoDeleteVc (NDIS 5.1)) dans Windows XP.
Plateforme cible	Windows
En-tête	ndis.h (inclure Ndis.h)
IRQL	<= DISPATCH_LEVEL

Voir aussi

MiniportCoCreateVc

Partager via