EVT_SERCX_FILECLOSE fonction de rappel (sercx.h)

Article
12/15/2024

La fonction de rappel d’événements EvtSerCxFileClose avertit le pilote du contrôleur série que l’objet de fichier qui représente l’appareil du contrôleur série a été libéré.

Syntaxe

EVT_SERCX_FILECLOSE EvtSercxFileclose;

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

Paramètres

[in] Device

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

Valeur de retour

Aucun

Remarques

Cette fonction doit supprimer l’appareil du 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 des interruptions sont activées. Toute mémoire allouée uniquement pour la durée de vie de l’objet de fichier doit être libérée dans cette fonction ou dans la fonction EvtSerCxFileCleanup.

Si le pilote du 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 à l’objet de fichier qui représente l’appareil du 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 attente 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 qui static Driver Verificationr (SDV) et d’autres outils de vérification nécessitent, 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Bureau
d’en-tête	sercx.h
IRQL	Appelé au <IRQL = DISPATCH_LEVEL

Voir aussi

EvtSerCxFileCleanup

SerCxInitialize

Partager via