SERCX_ACTIVITY Struktur (sercx.h)

Artikel
12/13/2024

Die SERCX_ACTIVITY-Struktur enthält eine Zusammenfassung der Arbeitsaufgaben, die für die Verarbeitung des seriellen Controllertreibers bereit sind.

Syntax

typedef struct _SERCX_ACTIVITY {
  ULONG   Size;
  BOOLEAN Transmitting;
  BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;

Angehörige

Size

Die Größe dieser Struktur in Byte. Die SerCxGetActivity--Methode verwendet dieses Element, um zu bestimmen, welche Version der Struktur der Aufrufer verwendet. Die Größe dieser Struktur kann sich in zukünftigen Versionen der Headerdatei Sercx.h ändern.

Transmitting

Gibt an, ob ein Übertragungsvorgang (Schreibvorgang) ausgeführt wird. Dieses Element ist TRUE, wenn ein Übertragungsvorgang ausgeführt wird. Andernfalls ist er FALSCH.

Receiving

Gibt an, ob ein Empfangsvorgang (Lesevorgang) ausgeführt wird. Dieses Element ist TRUE, wenn ein Empfangsvorgang ausgeführt wird. Andernfalls ist er FALSCH.

Bemerkungen

Diese Struktur muss vor der ersten Verwendung durch die SERCX_ACTIVITY_INIT-Funktion initialisiert werden. Anschließend aktualisieren Aufrufe der SerCxGetActivity--Methode den Inhalt dieser Struktur, um die aktuell ausstehende Arbeit anzugeben.

Die SERCX_ACTIVITY Struktur fasst die ausstehende Arbeit zusammen, die die serielle Frameworkerweiterung (SerCx) dem seriellen Controllertreiber zuweist. Diese Arbeit wird von E/A-Anforderungen von Clients gesteuert, aber eine E/A-Anforderung führt nicht notwendigerweise zu einer Arbeitsaufgabe. Wenn z. B. SerCx über eine ausreichende Menge empfangener Daten im Speicherpuffer verfügt, um eine ausstehende Leseanforderung abzuschließen, führt diese Anforderung nicht dazu, dass die empfangenden Member der SERCX_ACTIVITY Struktur auf TRUE festgelegt wird.

In der Regel wird SerCxGetActivity aus der Hauptschleife der Übertragungs-/Empfangs-DPC-Funktion im seriellen Controllertreiber aufgerufen. Diese Funktion ruft SerCxGetActivityauf, verarbeitet einen vollständigen Übertragungs- oder Empfangsvorgang und ruft dann SerCxGetActivity erneut auf, um zu bestimmen, ob ein Vorgang eines anderen Typs Arbeit erfordert. Wenn mehr Arbeit verfügbar ist, kann die DPC-Funktion diese Arbeit ausführen, bevor sie zurückgegeben wird.