共用方式為

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 呼叫