struttura SERIAL_STATUS (ntddser.h)

  • Articolo

La struttura SERIAL_STATUS contiene informazioni sullo stato sulla porta seriale.

Sintassi

typedef struct _SERIAL_STATUS {
  ULONG   Errors;
  ULONG   HoldReasons;
  ULONG   AmountInInQueue;
  ULONG   AmountInOutQueue;
  BOOLEAN EofReceived;
  BOOLEAN WaitForImmediate;
} SERIAL_STATUS, *PSERIAL_STATUS;

Members

Errors

Set di flag per indicare gli errori di ricezione che si sono verificati nel flusso di input. Questo membro è impostato su zero o sull'OR bit per bit di uno o più dei bit di flag seguenti.

Nome contrassegno Significato
SERIAL_ERROR_QUEUEOVERRUN Il buffer di input interno del driver del controller seriale è stato sovraccaricato dai dati ricevuti dal flusso di input. Il buffer di input è pieno o un carattere è stato ricevuto dopo il carattere EOF (fine del file).
SERIAL_ERROR_OVERRUN L'hardware che riceve FIFO è stato sovraccaricato dai dati ricevuti dal flusso di input.
SERIAL_ERROR_BREAK Si è verificata una condizione di interruzione nella riga di input.
SERIAL_ERROR_PARITY È stato rilevato un errore di parità in un byte ricevuto dal flusso di input.
SERIAL_ERROR_FRAMING È stato rilevato un errore di frame nei byte ricevuti dal flusso di input.
 

Dopo che il driver del controller seriale fornisce i flag SERIAL_ERROR_XXX accumulati per soddisfare una richiesta di IOCTL_SERIAL_GET_COMMSTATUS , il driver reimposta i flag su zero.

HoldReasons

Set di flag per indicare i motivi per cui la porta seriale è attualmente in attesa di trasmettere byte al flusso di output. Questo membro è impostato su zero o sull'OR bit per bit di uno o più dei bit di flag seguenti.

Nome contrassegno Significato
SERIAL_TX_WAITING_FOR_CTS In attesa del segnale CTS (chiaro da inviare).
SERIAL_TX_WAITING_FOR_DSR In attesa del segnale DSR (data set ready).
SERIAL_TX_WAITING_FOR_DCD In attesa del segnale DCD (rilevamento del gestore dati).
SERIAL_TX_WAITING_FOR_XON In attesa del segnale XON (trasmissione su).
SERIAL_TX_WAITING_ON_BREAK Invio di un segnale di interruzione (valore di spaziatura).
SERIAL_TX_WAITING_XOFF_SENT Inviato un segnale XOFF (trasmissione disattivata). Questo segnale contrassegna la fine della trasmissione dalla porta seriale, che attende quindi che il dispositivo sull'altra estremità della linea inizi la trasmissione. L'altro dispositivo riceve il segnale XOFF trasmesso come segnale XON.
 

HoldReasons è zero se la porta seriale non ha alcun motivo per interrompere la trasmissione di byte.

AmountInInQueue

Numero di byte di dati ricevuti dalla porta seriale attualmente disponibili per la lettura dal buffer di input.

AmountInOutQueue

Numero di byte di trasmissione dei dati attualmente in attesa di essere scritti dal buffer di output alla porta seriale.

EofReceived

Indica se è stato ricevuto un carattere EOF (fine file). Questo membro è TRUE se è stato ricevuto un EOF. In caso contrario, è FALSE. Il carattere EOF contrassegna la fine del flusso di input.

WaitForImmediate

Indica se la porta seriale è in attesa di trasmettere un carattere immediato. Questo membro è TRUE se la porta seriale è in attesa di trasmettere un carattere immediato. In caso contrario, è FALSE. La trasmissione di un carattere immediato potrebbe essere ritardata se un bit di flag diverso da SERIAL_TX_WAITING_FOR_XON è impostato nel membro HoldReasons . Per altre informazioni sui caratteri immediati, vedere IOCTL_SERIAL_IMMEDIATE_CHAR.

Commenti

Questa struttura viene utilizzata dalla richiesta IOCTL_SERIAL_GET_COMMSTATUS .

Requisiti

Requisito Valore
Intestazione ntddser.h

Vedi anche

IOCTL_SERIAL_GET_COMMSTATUS

IOCTL_SERIAL_IMMEDIATE_CHAR