SerCx2CompleteWait, fonction (sercx.h)
La méthode SerCx2CompleteWait informe la version 2 de l’extension de framework 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
Handle WDFDEVICE pour l’objet d’appareil framework qui représente le contrôleur série. Le pilote de 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
Aucun
Remarques
Lorsque SerCx2 reçoit une requête IOCTL_SERIAL_SET_WAIT_MASK d’un client, le gestionnaire de demandes dans SerCx2 appelle la fonction de rappel EvtSerCx2SetWaitMask pour avertir le pilote du contrôleur série que le masque d’attente a changé.
Lorsqu’un événement dans le nouveau masque d’attente se produit, le pilote appelle SerCx2CompleteWait pour notifier SerCx2 de l’événement. Si une demande de 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 quel événement s’est produit. Sinon, SerCx2 stocke l’événement dans son historique d’événements interne en prévision d’une prochaine demande de IOCTL_SERIAL_WAIT_ON_MASK.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8.1. |
| plateforme cible | Universel |
| d’en-tête | sercx.h |
| IRQL | <= DISPATCH_LEVEL |