EVT_SERCX2_SYSTEM_DMA_TRANSMIT_DRAIN_FIFOコールバック関数 (sercx.h)

EvtSerCx2SystemDmaTransmitDrainFifo イベント コールバック関数は、シリアル コントローラー ハードウェアの送信 FIFO をドレインするために、シリアル フレームワーク拡張機能 (SerCx2) のバージョン 2 によって呼び出されます。

構文

EVT_SERCX2_SYSTEM_DMA_TRANSMIT_DRAIN_FIFO EvtSercx2SystemDmaTransmitDrainFifo;

void EvtSercx2SystemDmaTransmitDrainFifo(
  [in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit
)
{...}

パラメーター

[in] SystemDmaTransmit

システム DMA 送信オブジェクトへの SERCX2SYSTEMDMATRANSMIT ハンドル。 シリアル コントローラー ドライバーは、以前にこのオブジェクトを作成するために、SerCx2SystemDmaTransmitCreate メソッドを呼び出しました。

戻り値

何一つ

備考

シリアル コントローラー ドライバーは、オプションとしてこの関数を実装できます。 ドライバーがこの関数を実装する場合は、EvtSerCx2SystemDmaTransmitCancelDrainFifo 実装し、EvtSerCx2SystemDmaTransmitPurgeFifo イベント コールバック関数を する必要もあります。 これらの関数を実装するドライバーは、システム DMA 転送オブジェクトを作成する SerCx2SystemDmaTransmitCreate 呼び出しにそれらを登録します。

SerCx2 は、EvtSerCx2SystemDmaTransmitDrainFifo 関数を呼び出し、実装されている場合は、システム DMA 送信トランザクションの終了時にシリアル コントローラー ハードウェアで送信 FIFO をドレインします。 この関数により、FIFO に残っているデータ バイトが、シリアル接続された周辺機器に確実に送信されます。 FIFO から最後のバイトが送信された後、EvtSerCx2SystemDmaTransmitDrainFifo 関数は、SerCx2 に通知する serCx2SystemDmaTransmitDrainFifoComplete メソッド を呼び出します。

シリアル コントローラー ドライバーが EvtSerCx2SystemDmaTransmitDrainFifo 関数 実装している場合、SerCx2 は、ドライバーが SerCx2SystemDmaTransmitDrainFifoComplete呼び出すまで、保留中の書き込み (IRP_MJ_WRITE) 要求を完了しません。

シリアル コントローラーに送信データを保持するためのハードウェア FIFO (または同様のバッファリング メカニズム) がある場合、ドライバーは EvtSerCx2SystemDmaTransmitDrainFifo 関数 実装する必要があります。 それ以外の場合、SerCx2 は保留中の書き込み要求が完了する前に送信 FIFO がドレインされたことを確認できません。 代わりに、SerCx2 は、書き込みバッファーの最後のバイトが送信 FIFO に書き込まれた後、この要求を完了します。 送信 FIFO に書き込まれたデータが、大幅な遅延なしで送信される保証はありません。 書き込み要求が完了した後に FIFO に残っているデータは、シリアル接続された周辺機器に送信される前に失われる可能性があります。 正常に完了した書き込み要求でこの予期しないデータ損失が発生すると、周辺機器ドライバーの信頼性の問題が発生する可能性があります。

詳細については、「SerCx2 System-DMA-Transmit Transactions」を参照してください。

例

EvtSerCx2SystemDmaTransmitDrainFifo コールバック関数 を定義するには、まず、定義するコールバック関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバーのコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールを すると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。

たとえば、という名前の MySystemDmaTransmitDrainFifo コールバック関数を定義するには、次のコード例に示すように、EVT_SERCX2_SYSTEM_DMA_TRANSMIT_DRAIN_FIFO 関数型を使用します。

EVT_SERCX2_SYSTEM_DMA_TRANSMIT_DRAIN_FIFO  MySystemDmaTransmitDrainFifo;

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

_Use_decl_annotations_
VOID
  MySystemDmaTransmitDrainFifo(
    SERCX2SYSTEMDMATRANSMIT  SystemDmaTransmit
    )
  {...}

EVT_SERCX2_SYSTEM_DMA_TRANSMIT_DRAIN_FIFO 関数型は、Sercx.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈を使用すると、ヘッダー ファイル内の EVT_SERCX2_SYSTEM_DMA_TRANSMIT_DRAIN_FIFO 関数型に適用される注釈が使用されます。 関数宣言の要件の詳細については、「KMDF ドライバーの関数ロール型を使用して関数を宣言する」を参照してください。 Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

必要条件

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

関連項目

EvtSerCx2SystemDmaTransmitCancelDrainFifo の

EvtSerCx2SystemDmaTransmitPurgeFifo の

IRP_MJ_WRITE

SERCX2SYSTEMDMATRANSMIT

SerCx2SystemDmaTransmitCreate

SerCx2SystemDmaTransmitDrainFifoComplete の