Fungsi BuildCommDCBA (winbase.h)

Mengisi struktur DCB tertentu dengan nilai yang ditentukan dalam string kontrol perangkat. String kontrol perangkat menggunakan sintaks mode perintah.

Sintaksis

BOOL BuildCommDCBA(
  [in]  LPCSTR lpDef,
  [out] LPDCB  lpDCB
);

Parameter

[in] lpDef

Informasi kontrol perangkat. Fungsi mengambil string ini, mengurainya, dan kemudian mengatur nilai yang sesuai dalam struktur DCB yang ditunjukkan oleh lpDCB.

String harus memiliki formulir yang sama dengan mode argumen baris perintah:

COMx[:][baud=b][parity=p][data=d][stop=s][to={on|off}][xon={on|off}][odsr={on|off}][octs={on|off}][dtr={on|off|hs}][rts={on|off|hs|tg}][idsr={on|off}]

Nama perangkat bersifat opsional, tetapi harus menentukan perangkat yang valid jika digunakan.

Misalnya, string berikut menentukan laju baud 1200, tanpa paritas, 8 bit data, dan 1 bit berhenti:

baud=1200 parity=N data=8 stop=1

[out] lpDCB

Penunjuk ke struktur DCB yang menerima informasi.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi BuildCommDCB hanya menyesuaikan anggota struktur DCB yang secara khusus dipengaruhi oleh parameter lpDef, dengan pengecualian berikut:

• Jika laju baud yang ditentukan adalah 110, fungsi mengatur bit berhenti ke 2 agar tetap kompatibel dengan mode sistem perintah.
• Secara default, BuildCommDCB menonaktifkan XON/XOFF dan kontrol alur perangkat keras. Untuk mengaktifkan kontrol alur, Anda harus secara eksplisit mengatur anggota struktur DCB yang sesuai.