COMMCONFIG-Struktur (winbase.h)
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) |