EVT_SERCX_RECEIVE_CANCEL回调函数 (sercx.h)

EvtSerCxReceiveCancel 事件回调函数通知串行控制器驱动程序挂起的接收请求已取消。

语法

EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;

void EvtSercxReceiveCancel(
  [in] WDFDEVICE Device
)
{...}

参数

[in] Device

表示串行控制器的框架设备对象的 WDFDEVICE 句柄。

返回值

备注

串行框架扩展 (SerCx) 调用此函数,以通知串行控制器驱动程序当前接收请求已被取消。 如果驱动程序正在进行未完成的接收操作,驱动程序应取消此操作,并调用 SerCxProgressReceive 方法来报告取消。 在 SerCxProgressReceive 调用中,将 BytesReceived 设置为取消操作前收到的字节数,并将 ReceiveStatus 设置为 SerCxStatusCancelled

若要注册 EvtSerCxReceiveCancel 回调函数,驱动程序必须调用 SerCxInitialize 方法。

示例

此回调的函数类型在 Sercx.h 中声明,如下所示。

typedef VOID
  EVT_SERCX_RECEIVE_CANCEL(
    __in WDFDEVICE Device
    );

若要定义命名MyEvtSerCxReceiveCancelEvtSerCerCxReceiveCancel 回调函数,必须先提供静态驱动程序验证程序 (SDV) 和其他验证工具所需的函数声明,如下所示。

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

然后,按如下所示实现回调函数。

VOID
  MyEvtSerCxReceiveCancel(
    __in WDFDEVICE Device
    )
{ ... }

有关函数声明的 SDV 要求的详细信息,请参阅 使用 KMDF 驱动程序的函数角色类型声明函数

要求

   
最低受支持的客户端 从Windows 8开始可用。
目标平台 桌面
Header sercx.h
IRQL 在 IRQL <调用 = DISPATCH_LEVEL

另请参阅

SerCxInitialize

SerCxProgressReceive