EVT_SERCX_TRANSMIT_CANCEL fonction de rappel (sercx.h)
La fonction de rappel d’événement EvtSerCxTransmitCancel avertit le pilote du contrôleur série que la demande de transmission en attente est annulée.
Syntaxe
EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;
void EvtSercxTransmitCancel(
[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 framework série (SerCx) appelle cette fonction pour informer le pilote du contrôleur série que la demande de transmission actuelle a été annulée. Si le pilote a une opération de transmission en cours, il doit annuler cette opération et appeler la méthode SerCxProgressTransmit pour signaler l’annulation. Dans l’appel SerCxProgressTransmit , définissez BytesTransmitted sur le nombre d’octets transmis avant l’annulation de l’opération et définissez TransmitStatus sur SerCxStatusCancelled.
Pour inscrire une fonction de rappel EvtSerCxTransmitCancel , 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_TRANSMIT_CANCEL(
__in WDFDEVICE Device
);
Pour définir une fonction de rappel EvtSerCxTransmitCancel nommée MyEvtSerCxTransmitCancel
, 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_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;
Ensuite, implémentez votre fonction de rappel comme suit.
VOID
MyEvtSerCxTransmitCancel(
__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 |