SerCx2SaveReceiveFifoOnD0Exit 函式（sercx.h）

發行項
10/30/2024

SerCx2SaveReceiveFifoOnD0Exit 方法會通知序列架構延伸模組（SerCx2）第 2 版，序列控制器硬體的接收 FIFO 包含應在序列控制器進入裝置低電源狀態之前儲存的數據。

語法

void SerCx2SaveReceiveFifoOnD0Exit(
  [in] SERCX2PIORECEIVE PioReceive,
  [in] ULONG            FifoSize
);

參數

[in] PioReceive

PIO 接收物件的 SERCX2PIORECEIVE 句柄。序列控制器驅動程式先前稱為 SerCx2PioReceiveCreate 方法來建立這個物件。

[in] FifoSize

傳輸 FIFO 包含之未讀取資料的位元元組數目。

傳回值

沒有

言論

當序列控制器即將進入低功率狀態時，SerCx2 和序列控制器驅動程式必須儲存任何可能保留在接收 FIFO 中的未讀取數據位元組。否則，當序列控制器進入低功率狀態時，此數據將會遺失。若要向 SerCx2 要求協助以儲存此資料，驅動程式會呼叫 SerCx2SaveReceiveFifoOnD0Exit。

驅動程式架構會呼叫驅動程式的 EvtDeviceD0Exit 或 EvtDeviceD0ExitPreInterruptsDisabled 事件回呼函式，告訴驅動程式準備序列控制器以結束 D0 裝置狀態。回應中，此函式會先取消 準備傳送 （RTS）行，以告訴裝置在序列連線的另一端，不要再傳送任何數據。接下來，函式會呼叫 SerCx2SaveReceiveFifoOnD0Exit。

SerCx2SaveReceiveFifoOnD0Exit 呼叫驅動程式的 EvtSerCx2PioReceiveReadBuffer 事件回呼函式，以從接收 FIFO 擷取數據。在此呼叫中，SerCx2 會以參數的形式提供 SerCx2 維護的內部軟體緩衝區指標，以便從接收 FIFO 儲存未讀取的數據，以準備進入低功率狀態。

之後，用戶端會將讀取（IRP_MJ_READ）要求傳送至序列控制器之後，SerCx2 會將位元組從這個內部軟體緩衝區複製到要求中的讀取緩衝區。