SERCX_ACTIVITY结构（sercx.h）

项目
12/13/2024

SERCX_ACTIVITY 结构包含可供串行控制器驱动程序处理的工作项摘要。

语法

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

成员

Size

此结构的大小（以字节为单位）。 SerCxGetActivity 方法使用此成员来确定调用方所使用的结构版本。此结构的大小可能会在 Sercx.h 头文件的未来版本中更改。

Transmitting

传输（写入）操作是否正在进行。如果传输操作正在进行，则此成员为 TRUE。否则为 FALSE。

Receiving

是否正在进行接收（读取）操作。如果正在执行接收操作，则此成员为 TRUE。否则为 FALSE。

言论

此结构必须先由 SERCX_ACTIVITY_INIT 函数在初始使用之前进行初始化。此后，调用 SerCxGetActivity 方法将更新此结构的内容，以指示当前挂起的工作。

SERCX_ACTIVITY 结构汇总了串行框架扩展（SerCx）分配给串行控制器驱动程序的挂起工作。此工作由来自客户端的 I/O 请求驱动，但 I/O 请求不一定生成工作项。例如，如果 SerCx 在其内存缓冲区中有足够的接收数据来完成挂起的读取请求，则此请求不会导致接收SERCX_ACTIVITY 结构的成员设置为 TRUE。

通常，SerCxGetActivity 是从串行控制器驱动程序中传输/接收 DPC 函数的主循环调用的。此函数调用 SerCxGetActivity，处理完整的传输或接收操作，然后再次调用 SerCxGetActivity，以确定另一种类型的操作是否需要工作。如果有更多工作可用，DPC 函数可能会在返回之前执行此操作。