Fungsi GetCommModemStatus (winbase.h)

Artikel
13/03/2024

Mengambil nilai control-register modem.

Sintaks

C++

BOOL GetCommModemStatus(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpModemStat
);

Parameter

[in] hFile

Handel ke perangkat komunikasi. Fungsi CreateFile mengembalikan handel ini.

[out] lpModemStat

Penunjuk ke variabel yang menerima status saat ini dari nilai control-register modem. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
MS_CTS_ON 0x0010	Sinyal CTS (clear-to-send) aktif.
MS_DSR_ON 0x0020	Sinyal DSR (data-set-ready) aktif.
MS_RING_ON 0x0040	Sinyal indikator cincin menyala.
MS_RLSD_ON 0x0080	Sinyal RLSD (receive-line-signal-detect) aktif.

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 GetCommModemStatus berguna saat Anda menggunakan fungsi WaitCommEvent untuk memantau sinyal indikator CTS, RLSD, DSR, atau cincin. Untuk mendeteksi kapan sinyal ini berubah status, gunakan WaitCommEvent lalu gunakan GetCommModemStatus untuk menentukan status setelah perubahan terjadi.

Fungsi gagal jika perangkat keras tidak mendukung nilai control-register.

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