COMMPROP-Struktur (winbase.h)

Enthält Informationen zu einem Kommunikationstreiber.

Syntax

typedef struct _COMMPROP {
  WORD  wPacketLength;
  WORD  wPacketVersion;
  DWORD dwServiceMask;
  DWORD dwReserved1;
  DWORD dwMaxTxQueue;
  DWORD dwMaxRxQueue;
  DWORD dwMaxBaud;
  DWORD dwProvSubType;
  DWORD dwProvCapabilities;
  DWORD dwSettableParams;
  DWORD dwSettableBaud;
  WORD  wSettableData;
  WORD  wSettableStopParity;
  DWORD dwCurrentTxQueue;
  DWORD dwCurrentRxQueue;
  DWORD dwProvSpec1;
  DWORD dwProvSpec2;
  WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;

Member

wPacketLength

Die Größe des gesamten Datenpakets, unabhängig von der angeforderten Datenmenge, in Byte.

wPacketVersion

Die Version der -Struktur.

dwServiceMask

Eine Bitmaske, die angibt, welche Dienste von diesem Anbieter implementiert werden. Der SP_SERIALCOMM Wert wird immer für Kommunikationsanbieter angegeben, einschließlich Modemanbietern.

dwReserved1

Reserviert; nicht verwenden.

dwMaxTxQueue

Die maximale Größe des internen Ausgabepuffers des Treibers in Bytes. Der Wert 0 (null) gibt an, dass vom seriellen Anbieter kein Maximalwert festgelegt wird.

dwMaxRxQueue

Die maximale Größe des internen Eingabepuffers des Treibers in Bytes. Der Wert 0 (null) gibt an, dass vom seriellen Anbieter kein Maximalwert festgelegt wird.

dwMaxBaud

Die maximal zulässige Baudrate in Bits pro Sekunde (bps). Dieser Member kann einer der folgenden Werte sein.

dwProvSubType

Der Kommunikationsanbietertyp.

dwProvCapabilities

Eine Bitmaske, die die vom Anbieter angebotenen Funktionen angibt. Dieser Member kann eine Kombination der folgenden Werte sein.

dwSettableParams

Eine Bitmaske, die die Kommunikationsparameter angibt, die geändert werden können. Dieser Member kann eine Kombination der folgenden Werte sein.

dwSettableBaud

Die baud-Raten, die verwendet werden können. Werte finden Sie im DwMaxBaud-Element .

wSettableData

Eine Bitmaske, die die Anzahl der Datenbits angibt, die festgelegt werden können. Dieser Member kann eine Kombination der folgenden Werte sein.

wSettableStopParity

Eine Bitmaske, die die Einstellungen für Stoppbit und Parität angibt, die ausgewählt werden können. Dieser Member kann eine Kombination der folgenden Werte sein.

dwCurrentTxQueue

Die Größe des internen Ausgabepuffers des Treibers in Bytes. Der Wert 0 gibt an, dass der Wert nicht verfügbar ist.

dwCurrentRxQueue

Die Größe des internen Eingabepuffers des Treibers in Bytes. Der Wert 0 gibt an, dass der Wert nicht verfügbar ist.

dwProvSpec1

Alle anbieterspezifischen Daten. Anwendungen sollten dieses Element ignorieren, es sei denn, sie verfügen über detaillierte Informationen zum Format der vom Anbieter benötigten Daten.

Legen Sie dieses Element auf COMMPROP_INITIALIZED fest, bevor Sie die GetCommProperties-Funktion aufrufen, um anzugeben, dass das wPacketLength-Element bereits gültig ist.

dwProvSpec2

Alle anbieterspezifischen Daten. Anwendungen sollten dieses Element ignorieren, es sei denn, sie verfügen über detaillierte Informationen zum Format der vom Anbieter benötigten Daten.

wcProvChar[1]

Alle anbieterspezifischen Daten. Anwendungen sollten dieses Element ignorieren, es sei denn, sie verfügen über detaillierte Informationen zum Format der vom Anbieter benötigten Daten.

Hinweise

Der Inhalt der Elemente dwProvSpec1, dwProvSpec2 und wcProvChar hängt vom Anbieteruntertyp ab (angegeben durch das dwProvSubType-Element ).

Wenn der Anbieteruntertyp PST_MODEM ist, werden diese Member wie folgt verwendet.

Anforderungen

Weitere Informationen

GetCommProperties