GetCommModemStatus-Funktion (winbase.h)

  • Artikel

Ruft die Modemsteuerungsregisterwerte ab.

Syntax

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

Parameter

[in] hFile

Ein Handle für das Kommunikationsgerät. Die CreateFile-Funktion gibt dieses Handle zurück.

[out] lpModemStat

Ein Zeiger auf eine Variable, die den aktuellen Zustand der Modemsteuerungsregisterwerte empfängt. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
MS_CTS_ON
0x0010
 Das CTS-Signal (Clear-to-Send) ist eingeschaltet.
MS_DSR_ON
0x0020
 Das DSR-Signal (data-set-ready) ist eingeschaltet.
MS_RING_ON
0x0040
 Das Ringanzeigesignal ist eingeschaltet.
MS_RLSD_ON
0x0080
 Das RLSD-Signal (receive-line-signal-detect) ist eingeschaltet.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetCommModemStatus-Funktion ist nützlich, wenn Sie die WaitCommEvent-Funktion verwenden, um die CTS-, RLSD-, DSR- oder Ringanzeigesignale zu überwachen. Um zu erkennen, wann diese Signale den Zustand ändern, verwenden Sie WaitCommEvent , und verwenden Sie dann GetCommModemStatus , um den Zustand nach einer Änderung zu bestimmen.

Die Funktion schlägt fehl, wenn die Hardware die Werte des Steuerelementregisters nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Kommunikationsfunktionen

Kommunikationsressourcen

CreateFile

WaitCommEvent