struktur SERIAL_STATUS (ntddser.h)

Struktur SERIAL_STATUS berisi informasi status tentang port serial.

Sintaks

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

Anggota

Errors

Sekumpulan bendera untuk menunjukkan kesalahan penerimaan yang telah terjadi di aliran input. Anggota ini diatur ke nol atau ke bitwise-OR dari satu atau beberapa bit bendera berikut.

Nama bendera	Makna
SERIAL_ERROR_QUEUEOVERRUN	Buffer input internal driver pengontrol serial diserbu oleh data yang diterima dari aliran input. Buffer input penuh, atau karakter diterima setelah karakter EOF (akhir file).
SERIAL_ERROR_OVERRUN	PERANGKAT keras yang menerima FIFO diserbu oleh data yang diterima dari aliran input.
SERIAL_ERROR_BREAK	Kondisi jeda terjadi pada baris input.
SERIAL_ERROR_PARITY	Kesalahan paritas terdeteksi dalam byte yang diterima dari aliran input.
SERIAL_ERROR_FRAMING	Kesalahan pembingkaian terdeteksi dalam byte yang diterima dari aliran input.

 

Setelah driver pengontrol serial memasok akumulasi bendera SERIAL_ERROR_XXX untuk memenuhi permintaan IOCTL_SERIAL_GET_COMMSTATUS , driver mengatur ulang bendera menjadi nol.

HoldReasons

Sekumpulan bendera untuk menunjukkan alasan port serial saat ini menunggu untuk mengirimkan byte ke aliran output. Anggota ini diatur ke nol atau ke bitwise-OR dari satu atau beberapa bit bendera berikut.

Nama bendera	Makna
SERIAL_TX_WAITING_FOR_CTS	Menunggu sinyal CTS (jelas dikirim).
SERIAL_TX_WAITING_FOR_DSR	Menunggu sinyal DSR (siap himpunan data).
SERIAL_TX_WAITING_FOR_DCD	Menunggu sinyal DCD (deteksi operator data).
SERIAL_TX_WAITING_FOR_XON	Menunggu sinyal XON (transmisi aktif).
SERIAL_TX_WAITING_ON_BREAK	Mengirim sinyal jeda (nilai penspasian).
SERIAL_TX_WAITING_XOFF_SENT	Mengirim sinyal XOFF (transmisi mati). Sinyal ini menandai akhir transmisi dari port serial, yang kemudian menunggu perangkat di ujung lain garis untuk mulai mengirimkan. Perangkat lain menerima sinyal XOFF yang dikirimkan sebagai sinyal XON.

 

HoldReasons adalah nol jika port serial tidak memiliki alasan untuk berhenti mengirimkan byte.

AmountInInQueue

Jumlah byte data yang diterima dari port serial yang saat ini tersedia untuk dibaca dari buffer input.

AmountInOutQueue

Jumlah byte data pengiriman yang saat ini menunggu untuk ditulis dari buffer output ke port serial.

EofReceived

Apakah karakter EOF (akhir file) telah diterima. Anggota ini TRUE jika EOF telah diterima. Jika tidak, itu FALSE. Karakter EOF menandai akhir aliran input.

WaitForImmediate

Apakah port serial sedang menunggu untuk mengirimkan karakter langsung. Anggota ini TRUE jika port seri menunggu untuk mengirimkan karakter langsung. Jika tidak, itu FALSE. Transmisi karakter langsung mungkin tertunda jika ada bendera selain SERIAL_TX_WAITING_FOR_XON diatur dalam anggota HoldReasons . Untuk informasi selengkapnya tentang karakter langsung, lihat IOCTL_SERIAL_IMMEDIATE_CHAR.

Keterangan

Struktur ini digunakan oleh permintaan IOCTL_SERIAL_GET_COMMSTATUS .

Persyaratan

Persyaratan	Nilai
Header	ntddser.h

Lihat juga

IOCTL_SERIAL_GET_COMMSTATUS

IOCTL_SERIAL_IMMEDIATE_CHAR