getCommConfig 函式 (winbase.h)

擷取通訊裝置目前的組態。

若要從設備管理器擷取預設組態設定，請使用 GetDefaultCommConfig 函式。

語法

BOOL GetCommConfig(
  [in]      HANDLE       hCommDev,
  [out]     LPCOMMCONFIG lpCC,
  [in, out] LPDWORD      lpdwSize
);

參數

[in] hCommDev

開啟通訊裝置的句柄。 CreateFile 函式會傳回這個句柄。

[out] lpCC

接收 COMMCONFIG 結構的緩衝區指標。

[in, out] lpdwSize

lpCC 所指向緩衝區的大小，以位元組為單位。 當函式傳回時，變數會包含函式成功時所複製的位元元組數目，或緩衝區太小時所需的位元組數目。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請使用 GetLastError 函 式。

規格需求

另請參閱

COMMCONFIG

通訊功能

通訊資源

CreateFile

GetDefaultCommConfig

SetCommConfig