次の方法で共有

SerCx2PioReceiveReady 関数 (sercx.h)

  • [アーティクル]

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

構文

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

パラメーター

[in] PioReceive

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

戻り値

何一つ

備考

PIO 受信トランザクションを開始するために、SerCx2 はイベント コールバック関数 EvtSerCx2PioReceiveReadBuffer を呼び出し、シリアル コントローラーの受信 FIFO からデータを転送する読み取りバッファーを提供します。 この関数からの戻り値が、受信 FIFO が空になる前に読み取りバッファーが部分的にしか入力されなかったことを示す場合、SerCx2 は、イベント コールバック ルーチン EvtSerCx2PioReceiveEnableReadyNotification 呼び出して、より多くのデータを読み取ることができるときに準備完了通知を実行できるようにします。

準備完了通知が有効になっていて、さらに多くのデータを読み取ることができる場合、シリアル コントローラー ドライバーは SerCx2PioReceiveReady 呼び出して SerCx2 に通知する必要があります。 この通知に応答して、SerCx2 は再び EvtSerCx2PioReceiveReadBuffer 関数を呼び出して、受信 FIFO から読み取りバッファーにさらに多くのデータを転送します。

シリアル コントローラー ドライバーは、EvtSerCx2PioReceiveEnableReadyNotification 関数の呼び出しに応答してのみ、SerCx2PioReceiveReady 呼び出す必要があります。

さらに、SerCx2 は、これらの準備完了通知を使用して、読み取り要求の処理中に間隔タイムアウトを検出します。 間隔のタイムアウトの詳細については、SERIAL_TIMEOUTSを参照してください。 準備完了通知の詳細については、「SerCx2 PIO-Receive Transactions」を参照してください。

必要条件

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

関連項目

EvtSerCx2PioReceiveReadBuffer の

SERCX2PIORECEIVE

SERIAL_TIMEOUTS

SerCx2PioReceiveCreate