Struttura COMMPROP (winbase.h)
Contiene informazioni su un driver di comunicazione.
Sintassi
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;
Members
wPacketLength
Dimensioni dell'intero pacchetto di dati, indipendentemente dalla quantità di dati richiesta, in byte.
wPacketVersion
Versione della struttura.
dwServiceMask
Maschera di bit che indica quali servizi vengono implementati da questo provider. Il valore SP_SERIALCOMM viene sempre specificato per i provider di comunicazioni, inclusi i provider di modem.
dwReserved1
Riservati; non usare.
dwMaxTxQueue
Dimensioni massime del buffer di output interno del driver, in byte. Un valore pari a zero indica che nessun valore massimo viene imposto dal provider seriale.
dwMaxRxQueue
Dimensioni massime del buffer di input interno del driver, in byte. Un valore pari a zero indica che nessun valore massimo viene imposto dal provider seriale.
dwMaxBaud
Velocità massima consentita di baud, in bit al secondo (bps). Questo membro può essere uno dei valori seguenti.
dwProvSubType
Tipo di provider di comunicazioni.
dwProvCapabilities
Maschera di bit che indica le funzionalità offerte dal provider. Questo membro può essere una combinazione dei valori seguenti.
dwSettableParams
Maschera di bit che indica i parametri di comunicazione che possono essere modificati. Questo membro può essere una combinazione dei valori seguenti.
dwSettableBaud
Velocità baud che possono essere utilizzate. Per i valori, vedere il membro dwMaxSoluted .
wSettableData
Maschera di bit che indica il numero di bit che è possibile impostare. Questo membro può essere una combinazione dei valori seguenti.
wSettableStopParity
Maschera di bit che indica le impostazioni di bit e parità che è possibile selezionare. Questo membro può essere una combinazione dei valori seguenti.
dwCurrentTxQueue
Dimensioni del buffer di output interno del driver, in byte. Il valore zero indica che il valore non è disponibile.
dwCurrentRxQueue
Dimensioni del buffer di input interno del driver, in byte. Il valore zero indica che il valore non è disponibile.
dwProvSpec1
Qualsiasi dato specifico del provider. Le applicazioni devono ignorare questo membro, a meno che non dispongano di informazioni dettagliate sul formato dei dati richiesti dal provider.
Impostare questo membro su COMMPROP_INITIALIZED prima di chiamare la funzione GetCommProperties per indicare che il membro wPacketLength è già valido.
dwProvSpec2
Qualsiasi dato specifico del provider. Le applicazioni devono ignorare questo membro, a meno che non dispongano di informazioni dettagliate sul formato dei dati richiesti dal provider.
wcProvChar[1]
Qualsiasi dato specifico del provider. Le applicazioni devono ignorare questo membro, a meno che non dispongano di informazioni dettagliate sul formato dei dati richiesti dal provider.
Commenti
Il contenuto dei membri dwProvSpec1, dwProvSpec2 e wcProvChar dipende dal sottotipo del provider (specificato dal membro dwProvSubType ).
Se il sottotipo del provider è PST_MODEM, questi membri vengono usati come indicato di seguito.
| Valore | Significato |
|---|---|
| dwProvSpec1 | Non usato. |
| dwProvSpec2 | Non usato. |
| wcProvChar | Contiene una struttura MODEMDEVCAPS . |
Requisiti
| Client minimo supportato | Windows XP |
| Server minimo supportato | Windows Server 2003 |
| Intestazione | winbase.h (include Windows.h) |