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 ドライバーの関数ロール型を使用した関数の宣言」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 以降で使用できます。 |
対象プラットフォーム | デスクトップ |
Header | sercx.h |
IRQL | IRQL <= DISPATCH_LEVEL で呼び出されます |