共用方式為

EVT_SERCX_RECEIVE_CANCEL回呼函式 （sercx.h）

  • 發行項

EvtSerCerCxReceiveCancel 事件回呼函式會通知序列控制器驅動程式擱置接收要求已取消。

語法

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

若要定義 EvtSerCerCxReceiveCancel 名為 MyEvtSerCxReceiveCancel的回呼函式，您必須先提供 靜態驅動程式驗證器 （SDV） 和其他驗證工具所需的函式宣告，如下所示。

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

然後，如下所示實作您的回呼函式。

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

如需函數宣告之 SDV 需求的詳細資訊，請參閱 使用 KMDF 驅動程式的函式角色類型來宣告函式。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 桌面
標頭 sercx.h
IRQL 在 IRQL <= DISPATCH_LEVEL 呼叫

另請參閱

SerCxInitialize

SerCxProgressReceive