SerCx2CompleteWait, fonction (sercx.h)

Article
02/29/2024

La méthode SerCx2CompleteWait notifie la version 2 de l’extension d’infrastructure série (SerCx2) qu’un événement dans le masque d’attente actuel s’est produit.

Syntaxe

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Paramètres

[in] Device

Un handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série. Le pilote du contrôleur série a créé cet objet dans sa fonction de rappel EvtDriverDeviceAdd . Pour plus d’informations, consultez SerCx2InitializeDevice.

[in] Event

Type d’événement qui met fin à l’opération d’attente actuelle. Ce paramètre est une valeur de masque d’attente. Chaque type d’événement correspond à un bit particulier dans le masque d’attente. Ce bit est défini pour indiquer que l’événement correspondant s’est produit. Pour plus d’informations sur les types d’événements qui peuvent être spécifiés par un masque d’attente, consultez SERIAL_EV_XXX.

Valeur de retour

None

Remarques

Lorsque SerCx2 reçoit une demande IOCTL_SERIAL_SET_WAIT_MASK d’un client, le gestionnaire de requêtes dans SerCx2 appelle la fonction de rappel EvtSerCx2SetWaitMask pour informer le pilote du contrôleur série que le masque d’attente a changé.

Lorsqu’un événement se produit dans le nouveau masque d’attente, le pilote appelle SerCx2CompleteWait pour informer SerCx2 de l’événement. Si une requête IOCTL_SERIAL_WAIT_ON_MASK précédemment envoyée est en attente dans SerCx2 au moment de l’appel SerCx2CompleteWait , SerCx2 termine cette requête avec un masque d’attente de sortie qui indique l’événement qui s’est produit. Sinon, SerCx2 stocke l’événement dans son historique interne en prévision d’une demande de IOCTL_SERIAL_WAIT_ON_MASK future.