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 |