EVT_SERCX_RECEIVE_CANCEL fonction de rappel (sercx.h)
La fonction de rappel d’événement EvtSerCxReceiveCancel avertit le pilote du 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
Handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.
Valeur de retour
Aucun
Remarques
L’extension d’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 attente en cours, le pilote doit annuler cette opération et appeler la méthode SerCxProgressReceive pour signaler l’annulation. Dans l’appel SerCxProgressReceive, définissez octetsReceived 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 qui static Driver Verificationr (SDV) et d’autres outils de vérification nécessitent, 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.
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 |