SerCx2PioReceiveReady-Funktion (sercx.h)

Artikel
10/30/2024

Die SerCx2PioReceiveReady Methode benachrichtigt Version 2 der seriellen Framework-Erweiterung (SerCx2), dass Daten aus dem empfangenen FIFO im seriellen Controller gelesen werden können.

Syntax

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

Parameter

[in] PioReceive

Ein SERCX2PIORECEIVE Handle für ein PIO-Empfangsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2PioReceiveCreate Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Nichts

Bemerkungen

Um eine PIO-Empfangstransaktion zu initiieren, ruft SerCx2 die EvtSerCx2PioReceiveReadBuffer Ereignisrückruffunktion auf und stellt einen Lesepuffer bereit, an den die Daten vom empfangenen FIFO im seriellen Controller übertragen werden sollen. Wenn der Rückgabewert dieser Funktion angibt, dass der Lesepuffer nur teilweise ausgefüllt wurde, bevor der Empfangs-FIFO leer wurde, ruft SerCx2 die EvtSerCx2PioReceiveEnableReadyNotification Ereignisrückrufroutine auf, um eine bereite Benachrichtigung zu ermöglichen, wenn mehr Daten zum Lesen verfügbar sind.

Wenn die bereite Benachrichtigung aktiviert ist und weitere Daten zum Lesen verfügbar sind, muss der serielle Controllertreiber SerCx2PioReceiveReady- aufrufen, um SerCx2 zu benachrichtigen. Als Reaktion auf diese Benachrichtigung ruft SerCx2 die EvtSerCx2PioReceiveReadBuffer Funktion erneut auf, um weitere Daten vom Empfangen FIFO in den Lesepuffer zu übertragen.

Der serielle Controllertreiber muss SerCx2PioReceiveReady- nur als Reaktion auf einen Aufruf der EvtSerCx2PioReceiveEnableReadyNotification-Funktion aufrufen.

Darüber hinaus verwendet SerCx2 diese bereiten Benachrichtigungen, um Intervalltimeouts während der Verarbeitung einer Leseanforderung zu erkennen. Weitere Informationen zu Intervalltimeouts finden Sie unter SERIAL_TIMEOUTS. Weitere Informationen zu bereiten Benachrichtigungen finden Sie unter SerCx2 PIO-Receive Transactions.