SerCxGetActivity, fonction (sercx.h)

Article
12/16/2024

La méthode SerCxGetActivity récupère l’état du travail en attente pour le pilote du contrôleur série.

Syntaxe

void SerCxGetActivity(
  [in]      WDFDEVICE       Device,
  [in, out] PSERCX_ACTIVITY Activity
);

Paramètres

[in] Device

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

[in, out] Activity

Pointeur vers une structure SERCX_ACTIVITY allouée par l’appelant. L’appelant doit avoir précédemment appelé la fonction SERCX_ACTIVITY_INIT pour initialiser cette structure avant son utilisation initiale. Par la suite, chaque SerCxGetActivity appelle met à jour le contenu de cette structure pour suivre les éléments de travail prêts à être traités par le pilote du contrôleur.

Valeur de retour

Aucun

Remarques

Le pilote de contrôleur série appelle cette méthode pour recevoir un résumé du travail de traitement qu’il doit effectuer pour le compte de l’extension du framework série (SerCx). En règle générale, SerCxGetActivity est appelée par la routine DPC de transmission/réception dans le pilote du contrôleur.

Le paramètre Activity pointe vers une structure SERCX_ACTIVITY qui décrit le travail en attente pour le pilote du contrôleur. Le travail en attente que SerCx affecte au pilote du contrôleur est piloté par les requêtes 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.

Pour parcourir les éléments de travail en attente, les appels de routine DPC de transmission/réception SerCxGetActivity, traitent une opération de transmission ou de réception complète, puis appellent SerCxGetActivity de nouveau pour déterminer si une autre opération d’un type différent nécessite du travail. Si une autre opération nécessite un travail, ce travail peut commencer pendant le même rappel, mais doit s’arrêter si la valeur de retour d’un appel à SerCxProgressReceive ou SerCxProgressTransmit dirige la routine DPC pour qu’elle s’exécute ultérieurement.

Un verrou protège la structure SERCX_ACTIVITY mise à jour par l’appel SerCxGetActivity. Pendant l’appel, ce verrou est acquis par les gestionnaires d’événements dans SerCx pour mettre à jour le résumé du travail actuellement en attente pour le pilote du contrôleur.