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.
| Wert | Bedeutung |
|---|---|
| dwProvSpec1 | Wird nicht verwendet. |
| dwProvSpec2 | Wird nicht verwendet. |
| wcProvChar | Enthält eine MODEMDEVCAPS-Struktur . |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Kopfzeile | winbase.h (einschließlich Windows.h) |