Struktur COMMPROP (winbase.h)

Berisi informasi tentang driver komunikasi.

Sintaks

typedef struct _COMMPROP {
  WORD  wPacketLength;
  WORD  wPacketVersion;
  DWORD dwServiceMask;
  DWORD dwReserved1;
  DWORD dwMaxTxQueue;
  DWORD dwMaxRxQueue;
  DWORD dwMaxBaud;
  DWORD dwProvSubType;
  DWORD dwProvCapabilities;
  DWORD dwSettableParams;
  DWORD dwSettableBaud;
  WORD  wSettableData;
  WORD  wSettableStopParity;
  DWORD dwCurrentTxQueue;
  DWORD dwCurrentRxQueue;
  DWORD dwProvSpec1;
  DWORD dwProvSpec2;
  WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;

Anggota

wPacketLength

Ukuran seluruh paket data, terlepas dari jumlah data yang diminta, dalam byte.

wPacketVersion

Versi struktur.

dwServiceMask

Bitmask yang menunjukkan layanan mana yang diterapkan oleh penyedia ini. Nilai SP_SERIALCOMM selalu ditentukan untuk penyedia komunikasi, termasuk penyedia modem.

dwReserved1

Dipesan; jangan gunakan.

dwMaxTxQueue

Ukuran maksimum buffer output internal driver, dalam byte. Nilai nol menunjukkan bahwa tidak ada nilai maksimum yang diberlakukan oleh penyedia serial.

dwMaxRxQueue

Ukuran maksimum buffer input internal driver, dalam byte. Nilai nol menunjukkan bahwa tidak ada nilai maksimum yang diberlakukan oleh penyedia serial.

dwMaxBaud

Laju baud maksimum yang diizinkan, dalam bit per detik (bps). Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BAUD_075 0x00000001	75 bps
BAUD_110 0x00000002	110 bps
BAUD_134_5 0x00000004	134,5 bps
BAUD_150 0x00000008	150 bps
BAUD_300 0x00000010	300 bps
BAUD_600 0x00000020	600 bps
BAUD_1200 0x00000040	1200 bps
BAUD_1800 0x00000080	1800 bps
BAUD_2400 0x00000100	2400 bps
BAUD_4800 0x00000200	4800 bps
BAUD_7200 0x00000400	7200 bps
BAUD_9600 0x00000800	9600 bps
BAUD_14400 0x00001000	14400 bps
BAUD_19200 0x00002000	19200 bps
BAUD_38400 0x00004000	38400 bps
BAUD_56K 0x00008000	56K bps
BAUD_57600 0x00040000	57600 bps
BAUD_115200 0x00020000	115200 bps
BAUD_128K 0x00010000	128K bps
BAUD_USER 0x10000000	Tingkat baud yang dapat diprogram.

dwProvSubType

Jenis penyedia komunikasi.

Nilai	Makna
PST_FAX 0x00000021	Perangkat FAKS
PST_LAT 0x00000101	Protokol LAT
PST_MODEM 0x00000006	Perangkat modem
PST_NETWORK_BRIDGE 0x00000100	Jembatan jaringan yang tidak ditentukan
PST_PARALLELPORT 0x00000002	Port paralel
PST_RS232 0x00000001	Port seri RS-232
PST_RS422 0x00000003	Port RS-422
PST_RS423 0x00000004	Port RS-423
PST_RS449 0x00000005	Port RS-449
PST_SCANNER 0x00000022	Perangkat pemindai
PST_TCPIP_TELNET 0x00000102	Protokol TCP/IP Telnet
PST_UNSPECIFIED 0x00000000	Tidak disebutkan
PST_X25 0x00000103	Standar X.25

dwProvCapabilities

Bitmask yang menunjukkan kemampuan yang ditawarkan oleh penyedia. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
PCF_16BITMODE 0x0200	Mode khusus 16-bit didukung
PCF_DTRDSR 0x0001	DTR (data-terminal-ready)/DSR (data-set-ready) didukung
PCF_INTTIMEOUTS 0x0080	Batas waktu interval didukung
PCF_PARITY_CHECK 0x0008	Pemeriksaan paritas didukung
PCF_RLSD 0x0004	RLSD (receive-line-signal-detect) didukung
PCF_RTSCTS 0x0002	RTS (request-to-send)/CTS (clear-to-send) didukung
PCF_SETXCHAR 0x0020	XON/XOFF yang dapat diatur didukung
PCF_SPECIALCHARS 0x0100	Dukungan karakter khusus yang diberikan
PCF_TOTALTIMEOUTS 0x0040	Total waktu habis (berlalu) didukung
PCF_XONXOFF 0x0010	Kontrol alur XON/XOFF didukung

dwSettableParams

Bitmask yang menunjukkan parameter komunikasi yang dapat diubah. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
SP_BAUD 0x0002	Laju baud
SP_DATABITS 0x0004	Bit data
SP_HANDSHAKING 0x0010	Jabat tangan (kontrol alur)
SP_PARITY 0x0001	Paritas
SP_PARITY_CHECK 0x0020	Pemeriksaan paritas
SP_RLSD 0x0040	RLSD (receive-line-signal-detect)
SP_STOPBITS 0x0008	Bit berhenti

dwSettableBaud

Tingkat baud yang dapat digunakan. Untuk nilai, lihat anggota dwMaxBaud .

wSettableData

Bitmask yang menunjukkan jumlah bit data yang dapat diatur. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
DATABITS_5 0x0001	5 bit data
DATABITS_6 0x0002	6 bit data
DATABITS_7 0x0004	7 bit data
DATABITS_8 0x0008	8 bit data
DATABITS_16 0x0010	16 bit data
DATABITS_16X 0x0020	Jalur lebar khusus melalui garis perangkat keras serial

wSettableStopParity

Bitmask yang menunjukkan pengaturan bit stop dan paritas yang dapat dipilih. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
STOPBITS_10 0x0001	1 bit stop
STOPBITS_15 0x0002	1,5 bit berhenti
STOPBITS_20 0x0004	2 bit berhenti
PARITY_NONE 0x0100	Tanpa paritas
PARITY_ODD 0x0200	Paritas ganjil
PARITY_EVEN 0x0400	Paritas genap
PARITY_MARK 0x0800	Tandai paritas
PARITY_SPACE 0x1000	Paritas ruang angkasa

dwCurrentTxQueue

Ukuran buffer output internal driver, dalam byte. Nilai nol menunjukkan bahwa nilai tidak tersedia.

dwCurrentRxQueue

Ukuran buffer input internal driver, dalam byte. Nilai nol menunjukkan bahwa nilai tidak tersedia.

dwProvSpec1

Data khusus penyedia apa pun. Aplikasi harus mengabaikan anggota ini kecuali mereka memiliki informasi terperinci tentang format data yang diperlukan oleh penyedia.

Atur anggota ini ke COMMPROP_INITIALIZED sebelum memanggil fungsi GetCommProperties untuk menunjukkan bahwa anggota wPacketLength sudah valid.

dwProvSpec2

Data khusus penyedia apa pun. Aplikasi harus mengabaikan anggota ini kecuali mereka memiliki informasi terperinci tentang format data yang diperlukan oleh penyedia.

wcProvChar[1]

Data khusus penyedia apa pun. Aplikasi harus mengabaikan anggota ini kecuali mereka memiliki informasi terperinci tentang format data yang diperlukan oleh penyedia.

Keterangan

Konten anggota dwProvSpec1, dwProvSpec2, dan wcProvChar bergantung pada subjenis penyedia (ditentukan oleh anggota dwProvSubType ).

Jika subjenis penyedia PST_MODEM, anggota ini digunakan sebagai berikut.

Nilai	Makna
dwProvSpec1	Tidak digunakan.
dwProvSpec2	Tidak digunakan.
wcProvChar	Berisi struktur MODEMDEVCAPS .

Persyaratan

Klien minimum yang didukung	Windows XP
Server minimum yang didukung	Windows Server 2003
Header	winbase.h (termasuk Windows.h)

Lihat juga

GetCommProperties