EVT_SERCX_FILECLOSE fonction de rappel (sercx.h)

La fonction de rappel d’événement EvtSerCxFileClose informe le pilote du contrôleur série que l’objet de fichier qui représente le périphérique de contrôleur série a été libéré.

Syntaxe

EVT_SERCX_FILECLOSE EvtSercxFileclose;

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

Paramètres

[in] Device

Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.

Valeur de retour

None

Remarques

Cette fonction doit supprimer le périphérique de contrôleur série de l’état dans lequel il est prêt à recevoir et à transmettre des données. Cette fonction doit désactiver les interruptions si les interruptions sont activées. Toute mémoire allouée uniquement pour la durée de vie de l’objet fichier doit être libérée dans cette fonction ou dans la fonction EvtSerCxFileCleanup .

Si le pilote de contrôleur série implémente une fonction EvtSerCxFileCleanup , l’extension de framework série (SerCx) appelle cette fonction avant d’appeler la fonction EvtSerCxFileClose . SerCx appelle la fonction EvtSerCxFileCleanup lorsqu’un client ferme le dernier handle de l’objet de fichier qui représente le périphérique de contrôleur série. Après cet appel, le pilote ne reçoit aucune nouvelle demande d’opérations d’E/S. SerCx appelle la fonction EvtSerCxFileClose lorsque l’objet de fichier est libéré, ce qui se produit uniquement une fois que toutes les demandes d’E/S en suspens sont terminées ou annulées.

Pour inscrire une fonction de rappel EvtSerCxFileClose , le pilote doit appeler la méthode SerCxInitialize .

Pour plus d’informations, consultez Framework File Objects.

Exemples

Le type de fonction de ce rappel est déclaré dans Sercx.h, comme suit.

typedef VOID
  EVT_SERCX_FILECLOSE(
    __in WDFDEVICE Device
    );

Pour définir une fonction de rappel EvtSerCxFileClose nommée MyEvtSerCxFileClose, vous devez d’abord fournir une déclaration de fonction requise par Static Driver Verifier (SDV) et d’autres outils de vérification, comme suit.

EVT_SERCX_FILECLOSE MyEvtSerCxFileClose;

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

VOID
  MyEvtSerCxFileClose(
    __in WDFDEVICE Device
    )
{ ... }

Pour plus d’informations sur les exigences SDV pour les déclarations de fonction, consultez Déclaration de fonctions à l’aide de types de rôles de fonction pour les pilotes KMDF.

Configuration requise

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

Voir aussi

EvtSerCxFileCleanup

SerCxInitialize