次の方法で共有

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 以降で使用できます。
対象プラットフォーム デスクトップ
Header sercx.h
IRQL IRQL <= DISPATCH_LEVEL で呼び出されます