EVT_SERCX_TRANSMIT_CANCEL fonction de rappel (sercx.h)

Article
02/27/2024

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

Partager via