SerCx2SystemDmaReceiveNewDataNotification 関数 (sercx.h)

SerCx2SystemDmaReceiveNewDataNotification メソッドは、シリアル コントローラー ハードウェアの受信 FIFO からデータを読み取ることができることをバージョン 2 のシリアル フレームワーク拡張機能 (SerCx2) に通知します。

構文

void SerCx2SystemDmaReceiveNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);

パラメーター

[in] SystemDmaReceive

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

戻り値

何一つ

備考

システム DMA 受信トランザクションを完了する前にシリアル コントローラーの受信 FIFO が空になった場合、SerCx2 はイベント コールバック関数 EvtSerCx2SystemDmaReceiveEnableNewDataNotification を呼び出して、実装されている場合は、受信 FIFO からデータを再び読み取ることができるときに SerCx2 が新しいデータ通知を受信できるようにします。

新しいデータ通知が有効になっている場合、シリアル コントローラー ドライバーは、シリアル コントローラーが新しいデータを受信した後に SerCx2 に通知するために、SerCx2SystemDmaReceiveNewDataNotification 呼び出す必要があります。 通知は、受信したデータの 1 つ以上の新しいバイトが転送される準備ができているか、システム DMA コントローラーによって既に転送されていることをドライバーが検出したときに発生します。

シリアル コントローラーは、EvtSerCx2SystemDmaReceiveEnableNewDataNotification 関数の呼び出しに応答する場合にのみ、SerCx2SystemDmaReceiveNewDataNotification 呼び出す必要があります。

シリアル コントローラー ドライバーがシステム DMA 受信トランザクションの新しいデータ通知をサポートしている場合、SerCx はこれらの通知を使用して、読み取り (IRP_MJ_READ) 要求の処理中に間隔タイムアウトを検出します。 間隔のタイムアウトの詳細については、SERIAL_TIMEOUTSを参照してください。 新規データ通知の詳細については、「SerCx2 System-DMA-Receive Transactions」を参照してください。

必要条件

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

関連項目

EvtSerCx2SystemDmaReceiveEnableNewDataNotification の

IRP_MJ_READ

SERCX2SYSTEMDMARECEIVE

SERIAL_TIMEOUTS

SerCx2SystemDmaReceiveCreate の