EVT_SERCX_RECEIVE_CANCEL fonction de rappel (sercx.h)
La fonction de rappel d’événement EvtSerCxReceiveCancel avertit le pilote de contrôleur série que la demande de réception en attente est annulée.
Syntaxe
EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;
void EvtSercxReceiveCancel(
[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
L’extension de l’infrastructure série (SerCx) appelle cette fonction pour informer le pilote du contrôleur série que la demande de réception actuelle a été annulée. Si le pilote a une opération de réception en cours, il doit annuler cette opération et appeler la méthode SerCxProgressReceive pour signaler l’annulation. Dans l’appel SerCxProgressReceive , définissez BytesReceived sur le nombre d’octets reçus avant l’annulation de l’opération et définissez ReceiveStatus sur SerCxStatusCancelled.
Pour inscrire une fonction de rappel EvtSerCxReceiveCancel , le pilote doit appeler la méthode SerCxInitialize .
Exemples
Le type de fonction de ce rappel est déclaré dans Sercx.h, comme suit.
typedef VOID
EVT_SERCX_RECEIVE_CANCEL(
__in WDFDEVICE Device
);
Pour définir une fonction de rappel EvtSerCxReceiveCancel nommée MyEvtSerCxReceiveCancel, 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_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;
Ensuite, implémentez votre fonction de rappel comme suit.
VOID
MyEvtSerCxReceiveCancel(
__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 |