estructura SERCX_ACTIVITY (sercx.h)

Artículo
12/13/2024

La estructura de SERCX_ACTIVITY contiene un resumen de los elementos de trabajo que están listos para que el controlador del controlador serie procese.

Sintaxis

typedef struct _SERCX_ACTIVITY {
  ULONG   Size;
  BOOLEAN Transmitting;
  BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;

Miembros

Size

Tamaño, en bytes, de esta estructura. El método SerCxGetActivity usa este miembro para determinar qué versión de la estructura usa el autor de la llamada. El tamaño de esta estructura puede cambiar en versiones futuras del archivo de encabezado Sercx.h.

Transmitting

Indica si una operación de transmisión (escritura) está en curso. Este miembro es TRUE si una operación de transmisión está en curso. De lo contrario, es FALSE.

Receiving

Indica si una operación de recepción (lectura) está en curso. Este miembro es TRUE si una operación de recepción está en curso. De lo contrario, es FALSE.

Observaciones

La función SERCX_ACTIVITY_INIT debe inicializar esta estructura antes de su uso inicial. Después, las llamadas al método SerCxGetActivity de actualizan el contenido de esta estructura para indicar el trabajo que está actualmente pendiente.

La estructura SERCX_ACTIVITY resume el trabajo pendiente que la extensión del marco serie (SerCx) asigna al controlador del controlador de serie. Este trabajo está controlado por solicitudes de E/S de clientes, pero una solicitud de E/S no genera necesariamente un elemento de trabajo. Por ejemplo, si SerCx tiene una cantidad suficiente de datos recibidos en su búfer de memoria para completar una solicitud de lectura pendiente, esta solicitud no hace que el miembro Receiveing de la estructura de SERCX_ACTIVITY se establezca en TRUE.

Normalmente, se llama a serCxGetActivity desde el bucle principal de la función DPC de transmisión/recepción en el controlador de controlador serie. Esta función llama a SerCxGetActivity, procesa una operación de transmisión o recepción completa y, a continuación, llama a SerCxGetActivity para determinar si una operación de otro tipo requiere trabajo. Si hay más trabajo disponible, la función DPC puede realizar este trabajo antes de que se devuelva.