EVT_SERCX_TRANSMIT_CANCEL fonction de rappel (sercx.h)

Article
12/13/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

Handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série.

Valeur de retour

Aucun

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 attente en cours, le pilote doit annuler cette opération et appeler la méthode SerCxProgressTransmit pour signaler l’annulation. Dans l’appel SerCxProgressTransmit, définissez octetsTransmitted 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 qui static Driver Verificationr (SDV) et d’autres outils de vérification nécessitent, 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.

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

Partager via