EVT_SERCX_FILEOPEN fonction de rappel (sercx.h)
La fonction de rappel d’événement EvtSerCxFileOpen avertit le pilote du contrôleur série qu’un client a ouvert un handle de fichier sur l’appareil du contrôleur série et qu’un objet de fichier a été créé pour représenter l’appareil.
Syntaxe
EVT_SERCX_FILEOPEN EvtSercxFileopen;
NTSTATUS EvtSercxFileopen(
[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
La fonction EvtSerCxFileOpen retourne STATUS_SUCCESS si l’appel réussit. Sinon, elle retourne un code d’état d’erreur approprié.
Remarques
L’extension de framework série (SerCx) appelle cette fonction pour préparer le matériel du contrôleur série afin d’accepter les demandes d’opérations d’E/S. Cette fonction doit configurer le contrôleur dans un état dans lequel il est prêt à recevoir et transmettre des données. Si des interruptions sont requises, cette fonction doit activer les interruptions. En outre, cette fonction doit allouer toute mémoire requise uniquement pendant la durée de vie de l’objet de fichier. Par exemple, cette fonction peut allouer une mémoire tampon de données d’interruption.
Pour inscrire une fonction de rappel EvtSerCxFileOpen, 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 NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Pour définir une fonction de rappel EvtSerCxFileOpen nommée MyEvtSerCxFileOpen, 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_FILEOPEN MyEvtSerCxFileOpen;
Ensuite, implémentez votre fonction de rappel comme suit.
NTSTATUS
MyEvtSerCxFileOpen(
__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 |