SerCx2SystemDmaReceiveNewDataNotification-Funktion (sercx.h)

Artikel
10/30/2024

Die SerCx2SystemDmaReceiveNewDataNotification 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 SerCx2SystemDmaReceiveNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);

Parameter

[in] SystemDmaReceive

Ein SERCX2SYSTEMDMARECEIVE Handle für ein System-DMA-Empfangsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2SystemDmaReceiveCreate Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Nichts

Bemerkungen

Wenn der Empfangs-FIFO im seriellen Controller leer wird, bevor eine System-DMA-Empfangstransaktion abgeschlossen werden kann, ruft SerCx2 die EvtSerCx2SystemDmaReceiveEnableNewDataNotification Ereignisrückruffunktion auf, um SerCx2 zu ermöglichen, eine neue Datenbenachrichtigung zu empfangen, wenn daten erneut verfügbar sind, um vom empfangenen FIFO gelesen zu werden.

Wenn die neue Datenbenachrichtigung aktiviert ist, muss der serielle Controllertreiber SerCx2SystemDmaReceiveNewDataNotification aufrufen, um SerCx2 zu benachrichtigen, nachdem der serielle Controller neue Daten empfängt. Eine Benachrichtigung tritt auf, wenn der Treiber erkennt, dass eine oder mehrere neue Bytes empfangener Daten entweder zur Übertragung bereit sind oder bereits vom DMA-Systemcontroller übertragen wurden.

Der serielle Controller muss SerCx2SystemDmaReceiveNewDataNotification nur als Reaktion auf einen Aufruf der EvtSerCx2SystemDmaReceiveEnableNewDataNotification-Funktion aufrufen.

Wenn ein serieller Controllertreiber neue Datenbenachrichtigungen für System-DMA-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 System-DMA-Receive Transactions.