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 トランザクション」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8.1 以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | sercx.h |
IRQL | <= DISPATCH_LEVEL |