EVT_SERCX2_FILEOPEN fonction de rappel (sercx.h)

La fonction de rappel d’événement EvtSerCx2FileOpen est appelée par la version 2 de l’extension d’infrastructure série (SerCx2) pour informer le pilote du contrôleur série qu’un client a ouvert une connexion logique au périphérique de contrôleur série et qu’un objet fichier a été créé pour représenter cette connexion.

Syntaxe

EVT_SERCX2_FILEOPEN EvtSercx2Fileopen;

NTSTATUS EvtSercx2Fileopen(
  [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 retournée

La fonction EvtSerCx2FileOpen retourne STATUS_SUCCESS si l’appel réussit. Sinon, elle retourne une erreur appropriée status code.

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. SerCx2 appelle la fonction EvtSerCx2FileOpen lorsqu’un pilote client ouvre un handle de fichier sur la pile de pilotes du contrôleur série.

Pour plus d’informations, consultez Framework File Objects.

Exemples

Pour définir une fonction de rappel EvtSerCx2FileOpen , 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 EvtSerCx2FileOpen nommée MyFileOpen, utilisez le type de fonction EVT_SERCX2_FILEOPEN , comme indiqué dans cet exemple de code :

EVT_SERCX2_FILEOPEN  MyFileOpen;

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

_Use_decl_annotations_
NTSTATUS
  MyFileOpen(
    WDFDEVICE  Device
    )
  {...}

Le type de fonction EVT_SERCX2_FILEOPEN 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_FILEOPEN 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