SerCx2SystemDmaReceiveNewDataNotification 関数 (sercx.h)

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

構文

void SerCx2SystemDmaReceiveNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);

パラメーター

[in] SystemDmaReceive

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

戻り値

なし

解説

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

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

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

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

要件

要件
サポートされている最小のクライアント Windows 8.1 以降で使用できます。
対象プラットフォーム ユニバーサル
Header sercx.h
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

EvtSerCx2SystemDmaReceiveEnableNewDataNotification

IRP_MJ_READ

SERCX2SYSTEMDMARECEIVE

SERIAL_TIMEOUTS

SerCx2SystemDmaReceiveCreate