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.

dwProvSubType

Jenis penyedia komunikasi.

dwProvCapabilities

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

dwSettableParams

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

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.

wSettableStopParity

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

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.

Persyaratan

Lihat juga

GetCommProperties