EVT_SERCX2_FILECLOSE fonction de rappel (sercx.h)

La fonction de rappel d’événement EvtSerCx2FileClose est appelée par la version 2 de l’extension d’infrastructure série (SerCx2) pour informer le pilote du contrôleur série que le client a libéré l’objet file qui représente la connexion logique au périphérique de contrôleur série.

Syntaxe

EVT_SERCX2_FILECLOSE EvtSercx2Fileclose;

void EvtSercx2Fileclose(
  [in] WDFDEVICE Device
)
{...}

Paramètres

[in] Device

Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série. Le pilote du contrôleur série a créé cet objet dans sa fonction de rappel EvtDriverDeviceAdd . Pour plus d’informations, consultez SerCx2InitializeDevice.

Valeur de retour

None

Remarques

Votre pilote de contrôleur série peut, en option, implémenter cette fonction. S’il est implémenté, le pilote inscrit cette fonction dans l’appel à la méthode SerCx2InitializeDevice qui termine l’initialisation de l’objet d’appareil framework pour le contrôleur série.

Pour plus d’informations, consultez Framework File Objects.

Exemples

Pour définir une fonction de rappel EvtSerCx2FileClose , vous devez d’abord fournir une déclaration de fonction qui identifie le type de fonction de rappel que vous définissez. Windows fournit un ensemble de types de fonctions de rappel pour les pilotes. La déclaration d’une fonction à l’aide des types de fonction de rappel 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 de rappel EvtSerCx2FileClose nommée MyFileClose, utilisez le type de fonction EVT_SERCX2_FILECLOSE , comme indiqué dans cet exemple de code :

EVT_SERCX2_FILECLOSE  MyFileClose;

Ensuite, implémentez votre fonction de rappel comme suit :

_Use_decl_annotations_
VOID
  MyFileClose(
    WDFDEVICE  Device
    )
  {...}

Le type de fonction EVT_SERCX2_FILECLOSE est défini dans le fichier d’en-tête Sercx.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 EVT_SERCX2_FILECLOSE 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 KMDF. Pour plus d’informations sur Use_decl_annotations, consultez Annotating Function Behavior.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.1.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sercx.h
IRQL	Appelé à IRQL <= DISPATCH_LEVEL.

Voir aussi

SerCx2InitializeDevice