SerCx2CustomReceiveTransactionNewDataNotification-Funktion (sercx.h)

Artikel
10/30/2024

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

Syntax

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Parameter

[in] CustomReceiveTransaction

Ein SERCX2CUSTOMRECEIVETRANSACTION Handle für ein benutzerdefiniertes Empfangsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2CustomReceiveTransactionCreate Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Nichts

Bemerkungen

Wenn der Empfangs-FIFO im seriellen Controller leer wird, bevor eine benutzerdefinierte Empfangstransaktion abgeschlossen werden kann, ruft SerCx2 den EvtSerCx2CustomReceiveTransactionEnableNewDataNotification Ereignisrückruffunktion auf, um eine neue Datenbenachrichtigung zu aktivieren, die auftreten kann, wenn neue Daten verfügbar sind, um aus dem empfangenen FIFO gelesen zu werden.

Wenn neue Datenbenachrichtigungen aktiviert sind und neue Daten gelesen werden können, muss der serielle Controllertreiber SerCx2CustomReceiveTransactionNewDataNotification aufrufen, um SerCx2 zu benachrichtigen. Diese Benachrichtigung tritt auf, wenn der Treiber erkennt, dass mindestens eine neue Byte empfangener Daten entweder vom benutzerdefinierten Datenübertragungsmechanismus übertragen werden kann oder bereits von diesem Mechanismus übertragen wurden.

Der serielle Controllertreiber muss SerCx2CustomReceiveTransactionNewDataNotification nur als Reaktion auf einen Aufruf der EvtSerCx2CustomReceiveTransactionEnableNewDataNotification-Funktion aufrufen.

Wenn ein serieller Controllertreiber neue Datenbenachrichtigungen für benutzerdefinierte Empfangstransaktionen unterstützt, verwendet SerCx diese Benachrichtigungen, um Intervalltimeouts während der Verarbeitung von Leseanforderungen (IRP_MJ_READ) zu erkennen. Weitere Informationen zu Intervalltimeouts finden Sie unter SERIAL_TIMEOUTS. Weitere Informationen zu neuen Datenbenachrichtigungen finden Sie unter SerCx2 Custom-Receive Transactions.