SerCxGetActivity 函式（sercx.h）

發行項
12/16/2024

SerCxGetActivity 方法會擷取序列控制器驅動程式擱置中工作的狀態。

語法

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

參數

[in] Device

代表序列控制器之架構裝置物件的WDFDEVICE句柄。

[in, out] Activity

呼叫端配置的 SERCX_ACTIVITY 結構的指標。呼叫端先前必須呼叫 SERCX_ACTIVITY_INIT 函式，才能初始化這個結構，才能初始使用。之後，每個 SerCxGetActivity 呼叫會更新此結構的內容，以追蹤控制器驅動程式準備好處理的工作專案。

傳回值

沒有

言論

序列控制器驅動程式會呼叫此方法，以接收它必須代表序列架構延伸模組執行之處理工作的摘要（SerCx）。通常，SerCxGetActivity 是由控制器驅動程式中的傳輸/接收 DPC 例程呼叫。

Activity 參數指向描述控制器驅動程式暫止工作的 SERCX_ACTIVITY 結構。 SerCx 指派給控制器驅動程式的暫止工作是由來自用戶端的 I/O 要求所驅動，但 I/O 要求不一定繁衍工作專案。例如，如果 SerCx 在其記憶體緩衝區中有足夠的已接收數據來完成暫止讀取要求，則此要求不會使接收SERCX_ACTIVITY 結構成員設為 TRUE。

若要迴圈處理暫止的工作專案，傳輸/接收 DPC 例程會呼叫 SerCxGetActivity、處理完整的傳輸或接收作業，然後再次呼叫 SerCxGetActivity，以判斷不同類型的另一個作業是否需要工作。如果另一個作業需要工作，此工作可能會在相同的回呼期間開始，但如果從呼叫 SerCxProgressReceive 或 SerCxProgressTransmit 指示 DPC 例程重新排程於稍後執行，則必須停止。

鎖定可保護 SerCxGetActivity 呼叫所更新的 SERCX_ACTIVITY 結構。在呼叫期間，SerCx 中的事件處理程式會取得此鎖定，以更新控制器驅動程式目前擱置的工作摘要。