SERCX_ACTIVITY struttura (sercx.h)

Articolo
02/29/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;

Members

Size

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

Transmitting

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

Receiving

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

Commenti

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 all'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 ha una quantità sufficiente di dati ricevuti nel buffer di memoria per completare una richiesta di lettura in sospeso, questa richiesta non causa l'impostazione true del membro ricevente della struttura SERCX_ACTIVITY .

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 lavoro. Se sono disponibili più operazioni, la funzione DPC potrebbe eseguire questo lavoro prima che venga restituita.