Fungsi SetCommState (winbase.h)

Artikel
08/27/2023

Mengonfigurasi perangkat komunikasi sesuai dengan spesifikasi dalam blok kontrol perangkat (struktur DCB ). Fungsi ini menginisialisasi ulang semua pengaturan perangkat keras dan kontrol, tetapi tidak mengosongkan output atau antrean input.

Sintaks

BOOL SetCommState(
  [in] HANDLE hFile,
  [in] LPDCB  lpDCB
);

Parameter

[in] hFile

Handel ke perangkat komunikasi. Fungsi CreateFile mengembalikan handel ini.

[in] lpDCB

Penunjuk ke struktur DCB yang berisi informasi konfigurasi untuk perangkat komunikasi yang ditentukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Fungsi SetCommState menggunakan struktur DCB untuk menentukan konfigurasi yang diinginkan. Fungsi GetCommState mengembalikan konfigurasi saat ini.

Untuk mengatur hanya beberapa anggota struktur DCB , Anda harus memodifikasi struktur DCB yang telah diisi oleh panggilan ke GetCommState. Ini memastikan bahwa anggota lain dari struktur DCB memiliki nilai yang sesuai.

Fungsi SetCommState gagal jika anggota XonChar dari struktur DCB sama dengan anggota XoffChar .

Saat SetCommState digunakan untuk mengonfigurasi 8250, pembatasan berikut berlaku untuk nilai untuk anggota ByteSize dan StopBits struktur DCB:

Jumlah bit data harus 5 hingga 8 bit.

Contoh

Misalnya, lihat Mengonfigurasi Sumber Daya Komunikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll