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
    );

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

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

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

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

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

要求

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

另请参阅

SerCxInitialize

SerCxProgressReceive