SerCx2CustomReceiveTransactionNewDataNotification 函式（sercx.h）

發行項
10/30/2024

SerCx2CustomReceiveTransactionNewDataNotification 方法會通知序列架構延伸模組（SerCx2）第 2 版，數據可從序列控制器硬體中的接收 FIFO 讀取。

語法

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

參數

[in] CustomReceiveTransaction

自定義接收物件的 SERCX2CUSTOMRECEIVETRANSACTION 句柄。序列控制器驅動程式先前稱為 SerCx2CustomReceiveTransactionCreate 方法來建立此物件。

傳回值

沒有

言論

如果串行控制器中的接收 FIFO 在自定義接收交易完成之前變成空白，SerCx2 會呼叫 EvtSerCx2CustomReceiveTransactionEnableNewDataNotification 事件回呼函式，如果實作，則啟用新的數據通知，以在接收 FIFO 中讀取新數據時發生。

如果已啟用新的數據通知，而且有新的數據可供讀取，序列控制器驅動程序必須呼叫 SerCx2CustomReceiveTransactionNewDataNotification 以通知 SerCx2。當驅動程式偵測到已接收數據的一或多個新位元組已準備好由自定義數據傳輸機制傳輸，或已由這個機制傳輸時，就會發生此通知。

序列控制器驅動程式必須呼叫 SerCx2CustomReceiveTransactionNewDataNotification，才能回應對 EvtSerCx2CustomReceiveTransactionEnableNewDataNotification 函式的呼叫。

如果序列控制器驅動程式支援自定義接收交易的新數據通知，SerCx 會使用這些通知來偵測讀取（IRP_MJ_READ）要求處理期間的時間間隔逾時。如需時間間隔逾時的詳細資訊，請參閱 SERIAL_TIMEOUTS。如需有關新數據通知的詳細資訊，請參閱 SerCx2 Custom-Receive Transactions。