SERCX_ACTIVITY structure (sercx.h)
La structure SERCX_ACTIVITY contient un résumé des éléments de travail prêts pour le traitement du pilote de contrôleur série.
Syntaxe
typedef struct _SERCX_ACTIVITY {
ULONG Size;
BOOLEAN Transmitting;
BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;
Membres
Size
Taille, en octets, de cette structure. La méthode SerCxGetActivity utilise ce membre pour déterminer la version de la structure utilisée par l’appelant. La taille de cette structure peut changer dans les versions futures du fichier d’en-tête Sercx.h.
Transmitting
Indique si une opération de transmission (écriture) est en cours. Ce membre a la valeur TRUE si une opération de transmission est en cours. Sinon, elle est FALSE.
Receiving
Indique si une opération de réception (lecture) est en cours. Ce membre a la valeur TRUE si une opération de réception est en cours. Sinon, elle est FALSE.
Remarques
Cette structure doit être initialisée par la fonction SERCX_ACTIVITY_INIT avant son utilisation initiale. Par la suite, les appels à la méthode SerCxGetActivity mettent à jour le contenu de cette structure pour indiquer le travail en attente.
La structure SERCX_ACTIVITY résume le travail en attente que l’extension d’infrastructure série (SerCx) affecte au pilote de contrôleur série. Ce travail est piloté par les demandes d’E/S des clients, mais une demande d’E/S ne génère pas nécessairement un élément de travail. Par exemple, si SerCx a une quantité suffisante de données reçues dans sa mémoire tampon pour effectuer une demande de lecture en attente, cette requête n’entraîne pas la définition du membre récepteur de la structure SERCX_ACTIVITY sur TRUE.
En règle générale, SerCxGetActivity est appelé à partir de la boucle main de la fonction DPC de transmission/réception dans le pilote de contrôleur série. Cette fonction appelle SerCxGetActivity, traite une opération de transmission ou de réception complète, puis appelle à nouveau SerCxGetActivity pour déterminer si une opération d’un autre type nécessite du travail. Si davantage de travail est disponible, la fonction DPC peut effectuer ce travail avant de retourner.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 8. |
| En-tête | sercx.h |