SerCx2CustomReceiveTransactionNewDataNotification-Funktion (sercx.h)

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 zu einem benutzerdefinierten Empfangenobjekt. Der serielle Controllertreiber hat zuvor die SerCx2CustomReceiveTransactionCreate-Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Keine

Bemerkungen

Wenn das empfangende FIFO im seriellen Controller leer wird, bevor eine benutzerdefinierte Empfangstransaktion abgeschlossen werden kann, ruft SerCx2 die EvtSerCx2CustomReceiveTransactionEnableNewDataNotification-Ereignisrückruffunktion auf, wenn sie implementiert wird, um eine neue Datenbenachrichtigung zu aktivieren, 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 ein oder mehrere neue Bytes von empfangenen Daten entweder vom benutzerdefinierten Datenübertragungsmechanismus übertragen werden oder bereits von diesem Mechanismus übertragen wurden.

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

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

Anforderungen

   
Unterstützte Mindestversion (Client) Ab Windows 8.1 verfügbar.
Zielplattform Universell
Header sercx.h
IRQL <= DISPATCH_LEVEL

Siehe auch

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

IRP_MJ_READ

SERCX2CUSTOMRECEIVETRANSACTION

SERIAL_TIMEOUTS

SerCx2CustomReceiveTransactionCreate