SERCX_ACTIVITY結構（sercx.h）

發行項
12/15/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 函式可能會在傳回之前執行這項工作。