structure SERCX_ACTIVITY (sercx.h)
La structure SERCX_ACTIVITY contient un résumé des éléments de travail prêts pour le traitement du pilote du 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 futures versions 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, il est FAUX.
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, il est FAUX.
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 actuellement en attente.
La structure SERCX_ACTIVITY récapitule le travail en attente que l’extension de l’infrastructure série (SerCx) affecte au pilote du contrôleur série. Ce travail est piloté par les demandes d’E/S des clients, mais une requête d’E/S ne génère pas nécessairement un élément de travail. Par exemple, si SerCx dispose d’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 true de la réception de membre de la structure SERCX_ACTIVITY.
En règle générale, SerCxGetActivity est appelée à partir de la boucle principale de la fonction DPC de transmission/réception dans le pilote du contrôleur série. Cette fonction appelle SerCxGetActivity, traite une opération de transmission ou de réception complète, puis appelle SerCxGetActivity de nouveau pour déterminer si une opération d’un autre type nécessite un travail. Si davantage de travail est disponible, la fonction DPC peut effectuer ce travail avant de retourner.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 8. |
| d’en-tête | sercx.h |