Struttura COMMCONFIG (winbase.h)

Articolo
08/27/2023

Contiene informazioni sullo stato di configurazione di un dispositivo di comunicazione.

Sintassi

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

Members

dwSize

Dimensioni della struttura, in byte. Il chiamante deve impostare questo membro su sizeof(COMMCONFIG).

wVersion

Numero di versione della struttura. Questo parametro può essere 1. La versione della struttura specifica del provider deve essere inclusa nel membro wcProviderData .

wReserved

Riservati; non usare.

dcb

Struttura del blocco di controllo del dispositivo (DCB) per i dispositivi seriali RS-232. Una struttura DCB è sempre presente indipendentemente dal sottotipo del driver di porta specificato nella struttura COMMPROP del dispositivo.

dwProviderSubType

Tipo di provider di comunicazioni e quindi il formato dei dati specifici del provider. Per un elenco dei tipi di provider di comunicazioni, vedere la descrizione della struttura COMMPROP .

dwProviderOffset

Offset dei dati specifici del provider rispetto all'inizio della struttura, in byte. Questo membro è zero se non sono presenti dati specifici del provider.

dwProviderSize

Dimensioni dei dati specifici del provider, in byte.

wcProviderData[1]

Dati specifici del provider facoltativi. Questo membro può essere di qualsiasi dimensione o può essere omesso. Poiché la struttura COMMCONFIG può essere espansa in futuro, le applicazioni devono usare il membro dwProviderOffset per determinare la posizione di questo membro.

Commenti

Se il sottotipo del provider è PST_RS232 o PST_PARALLELPORT, il membro wcProviderData viene omesso. Se il sottotipo del provider è PST_MODEM, il membro wcProviderData contiene una struttura MODEMSETTINGS .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Intestazione	winbase.h (include Windows.h)

Vedi anche