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
Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.
Valeur retournée
La fonction EvtSerCxFileOpen retourne STATUS_SUCCESS si l’appel réussit. Sinon, il retourne une erreur appropriée status code.
Remarques
L’extension de framework série (SerCx) appelle cette fonction pour préparer le matériel du contrôleur série à 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 la mémoire nécessaire uniquement pendant la durée de vie de l’objet 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 requise par Static Driver Verifier (SDV) et d’autres outils de vérification, 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.
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 |