winbase.h (COMMCONFIG 結構)

包含通訊裝置組態狀態的相關信息。

語法

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

成員

dwSize

結構的大小，以位元組為單位。 通話端必須將這個成員設定為 sizeof(COMMCONFIG)。

wVersion

結構的版本號碼。 此參數可以是 1。 wcProviderData 成員中應包含提供者特定結構的版本。

wReserved

保留;請勿使用。

dcb

RS-232 序列裝置的裝置控制區塊 (DCB) 結構。 不論裝置 COMMPROP 結構中指定的埠驅動程式子類型為何，DCB 結構一律存在。

dwProviderSubType

通訊提供者的類型，因此提供者特定數據的格式。 如需通訊提供者類型的清單，請參閱 COMMPROP 結構的描述。

dwProviderOffset

提供者特定數據相對於結構開頭的位移，以位元組為單位。 如果沒有提供者特定的數據，則此成員為零。

dwProviderSize

提供者特定數據的大小，以位元組為單位。

wcProviderData[1]

選擇性的提供者特定數據。 這個成員可以是任何大小，也可以省略。 由於未來可能會擴充 COMMCONFIG 結構，因此應用程式應該使用 dwProviderOffset 成員來判斷此成員的位置。

備註

如果提供者子類型PST_RS232或PST_PARALLELPORT，則會省略 wcProviderData 成員。 如果提供者子類型 PST_MODEM，wcProviderData 成員會包含 MODEMSETTINGS 結構。

規格需求

需求	值
最低支援的用戶端	Windows XP
最低支援的伺服器	Windows Server 2003
標頭	winbase.h (包含 Windows.h)

另請參閱

COMMPROP

DCB

GetCommProperties

MODEMSETTINGS