SERCX_ACTIVITY-Struktur (sercx.h)

Artikel
02/26/2024

Die SERCX_ACTIVITY-Struktur enthält eine Zusammenfassung der Arbeitselemente, 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;

Member

Size

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

Transmitting

Gibt an, ob ein Übertragungsvorgang (Schreibvorgang) ausgeführt wird. Dieser Member ist TRUE, wenn ein Übertragungsvorgang ausgeführt wird. Andernfalls ist es FALSE.

Receiving

Gibt an, ob ein Empfangsvorgang (Lesevorgang) ausgeführt wird. Dieser Member ist TRUE, wenn ein Empfangsvorgang ausgeführt wird. Andernfalls ist es FALSE.

Hinweise

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

Die SERCX_ACTIVITY-Struktur fasst die ausstehenden Arbeiten zusammen, die die Serielle Framework-Erweiterung (SerCx) dem seriellen Controllertreiber zuweist. Diese Arbeit wird durch E/A-Anforderungen von Clients gesteuert, aber eine E/A-Anforderung erzeugt nicht unbedingt ein Arbeitselement. Wenn SerCx beispielsweise über eine ausreichende Menge empfangener Daten im Speicherpuffer verfügt, um eine ausstehende Leseanforderung abzuschließen, führt diese Anforderung nicht dazu, dass der Empfangende Member der SERCX_ACTIVITY-Struktur auf TRUE festgelegt wird.

In der Regel wird SerCxGetActivity aus der Standard-Schleife der DPC-Funktion senden/empfangen im seriellen Controllertreiber aufgerufen. Diese Funktion ruft SerCxGetActivity auf, verarbeitet einen vollständigen Sende- oder Empfangsvorgang und ruft dann SerCxGetActivity erneut auf, um festzustellen, 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.