Freigeben über


GetCommMask-Funktion (winbase.h)

Ruft den Wert der Ereignismaske für ein angegebenes Kommunikationsgerät ab.

Syntax

BOOL GetCommMask(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpEvtMask
);

Parameter

[in] hFile

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

[out] lpEvtMask

Ein Zeiger auf die Variable, die eine Maske von Ereignissen empfängt, die derzeit aktiviert sind. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
EV_BREAK
0x0040
Bei der Eingabe wurde ein "break" erkannt.
EV_CTS
0x0008
Das CTS-Signal (Clear-to-Send) hat den Zustand geändert.
EV_DSR
0x0010
Das DSR-Signal (Data-set-ready) hat den Zustand geändert.
EV_ERR
0x0080
Es ist ein Zeilen-status-Fehler aufgetreten. Zeilen-status-Fehler werden CE_FRAME, CE_OVERRUN und CE_RXPARITY.
EV_EVENT1
0x0800
Ein Ereignis des ersten anbieterspezifischen Typs ist aufgetreten.
EV_EVENT2
0x1000
Ein Ereignis des zweiten anbieterspezifischen Typs ist aufgetreten.
EV_PERR
0x0200
Ein Druckerfehler ist aufgetreten.
EV_RING
0x0100
Ein Ringindikator wurde erkannt.
EV_RLSD
0x0020
Das RLSD-Signal (receive-line-signal-detect) hat den Zustand geändert.
EV_RX80FULL
0x0400
Der Empfangspuffer ist zu 80 Prozent voll.
EV_RXCHAR
0x0001
Ein Zeichen wurde empfangen und im Eingabepuffer platziert.
EV_RXFLAG
0x0002
Das Ereigniszeichen wurde empfangen und im Eingabepuffer platziert. Das Ereigniszeichen wird in der DCB-Struktur des Geräts angegeben, die mithilfe der SetCommState-Funktion auf einen seriellen Port angewendet wird.
EV_TXEMPTY
0x0004
Das letzte Zeichen im Ausgabepuffer wurde gesendet.

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 GetCommMask-Funktion verwendet eine Maskenvariable, um den Satz von Ereignissen anzugeben, die für eine bestimmte Kommunikationsressource überwacht werden können. Ein Handle für die Kommunikationsressource kann in einem Aufruf der WaitCommEvent-Funktion angegeben werden, die wartet, bis eines der Ereignisse auftritt. Um die Ereignismaske einer Kommunikationsressource zu ändern, verwenden Sie die SetCommMask-Funktion .

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

DCB

SetCommMask

WaitCommEvent