SerCx2CompleteWait 函数 (sercx.h)

项目
02/26/2024

SerCx2CompleteWait 方法通知串行框架扩展版本 2 (SerCx2) 当前等待掩码中发生了事件。

语法

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

参数

[in] Device

表示串行控制器的框架设备对象的 WDFDEVICE 句柄。串行控制器驱动程序在其 EvtDriverDeviceAdd 回调函数中创建此对象。有关详细信息，请参阅 SerCx2InitializeDevice。

[in] Event

正在结束当前等待操作的事件的类型。此参数是等待掩码值。每个事件类型对应于等待掩码中的一个特定位。此位设置为指示发生了相应的事件。有关可由等待掩码指定的事件类型的详细信息，请参阅 SERIAL_EV_XXX。

返回值

无

备注

当 SerCx2 收到来自客户端的IOCTL_SERIAL_SET_WAIT_MASK 请求时，SerCx2 中的请求处理程序会调用 EvtSerCx2SetWaitMask 回调函数，以通知串行控制器驱动程序等待掩码已更改。

当发生新的等待掩码中的事件时，驱动程序会调用 SerCx2CompleteWait 来通知 SerCx2 事件。如果在调用 SerCx2CompleteWait 时，以前发送的IOCTL_SERIAL_WAIT_ON_MASK 请求在 SerCx2 中挂起，则 SerCx2 使用指示发生的事件的输出等待掩码完成此请求。否则，SerCx2 将事件存储在其内部事件历史记录中，以预期将来 IOCTL_SERIAL_WAIT_ON_MASK 请求。