Fungsi SetCommState (winbase.h)
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 |