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 ドライバーの関数ロール型を使用した関数の宣言」を参照してください。

要件

こちらもご覧ください

SerCxInitialize

SerCxProgressReceive