struttura SERCX_ACTIVITY (sercx.h)

Articolo
12/15/2024

La struttura SERCX_ACTIVITY contiene un riepilogo degli elementi di lavoro pronti per l'elaborazione del driver del controller seriale.

Sintassi

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

Membri

Size

Dimensione, in byte, di questa struttura. Il metodo serCxGetActivity utilizza questo membro per determinare quale versione della struttura sta utilizzando il chiamante. Le dimensioni di questa struttura potrebbero cambiare nelle versioni future del file di intestazione Sercx.h.

Transmitting

Indica se è in corso un'operazione di trasmissione (scrittura). Questo membro è TRUE se è in corso un'operazione di trasmissione. In caso contrario, è FALSE.

Receiving

Indica se è in corso un'operazione di ricezione (lettura). Questo membro è TRUE se è in corso un'operazione di ricezione. In caso contrario, è FALSE.

Osservazioni

Questa struttura deve essere inizializzata dalla funzione SERCX_ACTIVITY_INIT prima dell'uso iniziale. Successivamente, le chiamate al metodo SerCxGetActivity aggiornano il contenuto di questa struttura per indicare il lavoro attualmente in sospeso.

La struttura SERCX_ACTIVITY riepiloga il lavoro in sospeso assegnato dall'estensione del framework seriale (SerCx) al driver del controller seriale. Questo lavoro è basato sulle richieste di I/O dai client, ma una richiesta di I/O non genera necessariamente un elemento di lavoro. Ad esempio, se SerCx dispone di una quantità sufficiente di dati ricevuti nel relativo buffer di memoria per completare una richiesta di lettura in sospeso, questa richiesta non determina l'impostazione del membro ricevente della struttura SERCX_ACTIVITY su TRUE.

In genere, SerCxGetActivity viene chiamato dal ciclo principale della funzione DPC di trasmissione/ricezione nel driver del controller seriale. Questa funzione chiama SerCxGetActivity, elabora un'operazione di trasmissione o ricezione completa e quindi chiama di nuovo SerCxGetActivity per determinare se un'operazione di un altro tipo richiede il lavoro. Se sono disponibili altre operazioni, la funzione DPC potrebbe eseguire questa operazione prima che venga restituita.