通过

EVT_SERCX_TRANSMIT_CANCEL回调函数 （sercx.h）

  • 项目

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

语法

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

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

参数

[in] Device

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

返回值

没有

言论

串行框架扩展 （SerCx） 调用此函数，以通知串行控制器驱动程序当前传输请求已被取消。 如果驱动程序正在进行未完成的传输操作，驱动程序应取消此操作，并调用 SerCxProgressTransmit 方法来报告取消。 在 SerCxProgressTransmit 调用中，将 BytesTransmitted 设置为取消操作前传输的字节数，并将 TransmitStatus 设置为 SerCxStatusCancelled。

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

例子

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

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

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

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

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

要求

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