COMMCONFIG-Struktur (winbase.h)

Artikel
08/27/2023

Enthält Informationen zum Konfigurationsstatus eines Kommunikationsgeräts.

Syntax

typedef struct _COMMCONFIG {
  DWORD dwSize;
  WORD  wVersion;
  WORD  wReserved;
  DCB   dcb;
  DWORD dwProviderSubType;
  DWORD dwProviderOffset;
  DWORD dwProviderSize;
  WCHAR wcProviderData[1];
} COMMCONFIG, *LPCOMMCONFIG;

Member

dwSize

Die Größe der Struktur in Bytes. Der Aufrufer muss diesen Member auf sizeof(COMMCONFIG)festlegen.

wVersion

Die Versionsnummer der -Struktur. Dieser Parameter kann 1 sein. Die Version der anbieterspezifischen Struktur sollte im wcProviderData-Member enthalten sein.

wReserved

Reserviert; nicht verwenden.

dcb

Die DCB-Struktur (Device Control Block) für serielle RS-232-Geräte. Eine DCB-Struktur ist immer vorhanden, unabhängig vom Porttreiberuntertyp, der in der COMMPROP-Struktur des Geräts angegeben ist.

dwProviderSubType

Der Typ des Kommunikationsanbieters und damit das Format der anbieterspezifischen Daten. Eine Liste der Kommunikationsanbietertypen finden Sie in der Beschreibung der COMMPROP-Struktur .

dwProviderOffset

Der Offset der anbieterspezifischen Daten relativ zum Anfang der Struktur in Bytes. Dieser Member ist null, wenn keine anbieterspezifischen Daten vorhanden sind.

dwProviderSize

Die Größe der anbieterspezifischen Daten in Bytes.

wcProviderData[1]

Optionale anbieterspezifische Daten. Dieser Member kann eine beliebige Größe aufweisen oder weggelassen werden. Da die COMMCONFIG-Struktur in Zukunft erweitert werden kann, sollten Anwendungen den DwProviderOffset-Member verwenden, um den Speicherort dieses Members zu bestimmen.

Hinweise

Wenn der Anbieteruntertyp PST_RS232 oder PST_PARALLELPORT ist, wird das wcProviderData-Element weggelassen. Wenn der Anbieteruntertyp PST_MODEM ist, enthält das wcProviderData-Element eine MODEMSETTINGS-Struktur .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Kopfzeile	winbase.h (Windows.h einschließen)

Weitere Informationen

Share via