SerCxCompleteWait 函式（sercx.h）

發行項
12/15/2024

SerCxCompleteWait 方法會通知序列架構延伸模組（SerCx）目前等候遮罩中的事件已發生。

語法

NTSTATUS SerCxCompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

參數

[in] Device

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

[in] Event

結束目前等候作業的事件類型。此參數是等候遮罩值。每個事件類型都會對應至等候掩碼中的特定位。此位設定為表示已發生對應的事件。如需等候遮罩可指定之事件類型的詳細資訊，請參閱 SERIAL_EV_XXX。

傳回值

如果呼叫成功，SerCxCompleteWait 會傳回STATUS_SUCCESS。可能的錯誤傳回值包括下列狀態代碼。

傳回碼	描述
STATUS_INVALID_PARAMETER	指定的事件不包含在目前的等候掩碼中。

言論

當 SerCx 從用戶端收到 IOCTL_SERIAL_SET_WAIT_MASK 要求時，SerCx 中的要求處理程式會呼叫 EvtSerCxWaitmask 回呼函式，以通知序列控制器驅動程式等候遮罩已變更。等候遮罩會指定要監視的序列控制器一組硬體事件。在此呼叫期間，驅動程式會捨棄先前 EvtSerCxWaitmask 呼叫中指定的任何舊等候遮罩，然後設定序列控制器硬體來偵測新等候掩碼中的事件。

稍後，當新等候遮罩中的事件發生時，驅動程式會呼叫 SerCxCompleteWait，以通知 SerCx 事件。如果先前傳送的 IOCTL_SERIAL_WAIT_ON_MASK 要求擱置中，SerCxCompleteWait 完成此要求，其狀態為 STATUS_SUCCESS，以及指出發生事件的輸出等候遮罩。否則，SerCxCompleteWait 會將事件儲存在其內部事件歷程記錄中，以預期未來 IOCTL_SERIAL_WAIT_ON_MASK 要求。