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

という名前の EvtSerCxReceiveCancel コールバック関数を定義するには、まず、静的ドライバー検証ツール (SDV) およびその他の検証ツール 必要な関数宣言を次のように指定する必要があります。

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

次に、次のようにコールバック関数を実装します。

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

関数宣言の SDV 要件の詳細については、「宣言する関数を宣言する KMDF ドライバーのの関数の役割の種類を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8 以降で使用できます。
ターゲット プラットフォーム の	デスクトップ
ヘッダー	sercx.h
IRQL	IRQL <= DISPATCH_LEVEL で呼び出されます

関連項目

SerCxInitialize

SerCxProgressReceive の