SerCx2CustomReceiveTransactionNewDataNotification 関数 (sercx.h)

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

構文

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

パラメーター

[in] CustomReceiveTransaction

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

戻り値

何一つ

備考

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

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

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

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

必要条件

関連項目

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification の

IRP_MJ_READ

SERCX2CUSTOMRECEIVETRANSACTION

SERIAL_TIMEOUTS

SerCx2CustomReceiveTransactionCreate