在开发需要与串口设备(如传感器、调制解调器、GPS 设备等)通信的应用程序时,用户通常需要从可用的串口列表中选择一个进行连接。
在 MFC应用程序中显示串口列表,通常涉及到两个主要步骤:首先检测可用的串口,然后将它们显示在用户界面元素(如 CComboBox
)中。以下是一个基本的步骤指南:
1. 检测可用串口
检测设备管理器中的端口,特别是 COM 端口,通常涉及到读取 Windows 注册表或使用 Windows Management Instrumentation (WMI) 查询。这需要使用 COM 接口和 WMI 查询。请注意,这需要一些 Windows 平台特有的库和接口,通常在 C++ 中通过包含 <Wbemidl.h>
实现,并且还需要在项目中链接 WbemUuid.lib
。
通过代码中的 #pragma
指令链接 WbemUuid.lib
:
#include <Wbemidl.h>
#include <comdef.h>
#pragma comment(lib, "wbemuuid.lib")
函数使用 COM 接口和 WMI 查询串口:
int GetSerialport() {
HRESULT hres;
// 初始化 COM 库
hres = CoInitializeEx(0, COINIT_MULTITHREADED);
if (FAILED(hres)) {
std::cout << "Failed to initialize COM library." << std::endl;
return 1; // 程序失败退出
}
// 设置 COM 安全级别
hres = CoInitializeSecurity(
NULL,
-1, // COM 身份验证
NULL, // 身份验证服务
NULL, // 保留
RPC_C_AUTHN_LEVEL_DEFAULT, // 默认身份验证
RPC_C_IMP_LEVEL_IMPERSONATE, // 默认模拟
NULL, // 身份验证信息
EOAC_NONE, // 附加功能
NULL // 保留
);
if (FAILED(hres)) {
std::cout << "Failed to initialize security." << std::endl;
CoUninitialize();
return 1; // 程序失败退出
}
// 获取对 WMI 的指针
IWbemLocator *pLoc = NULL;
hres = CoCreateInstance(
CLSID_WbemLocator,
0,
CLSCTX_INPROC_SERVER,
IID_IWbemLocator, (LPVOID *)&pLoc);
if (FAILED(hres)) {
std::cout << "Failed to create IWbemLocator object." << std::endl;
CoUninitialize();
return 1; // 程序失败退出
}
IWbemServices *pSvc = NULL;
// 连接到 WMI
hres = pLoc->ConnectServer(
_bstr_t(L"ROOT\\CIMV2"), // WMI 命名空间
NULL, // 用户名
NULL, // 密码
0, // 区域设置
NULL, // 安全标记
0, // 权限
0, // 上下文
&pSvc // IWbemServices 指针
);
if (FAILED(hres)) {
std::cout << "Could not connect to WMI." << std::endl;
pLoc->Release();
CoUninitialize();
return 1; // 程序失败退出
}
std::cout << "Connected to ROOT\\CIMV2 WMI namespace." << std::endl;
// 设置查询语句
IEnumWbemClassObject* pEnumerator = NULL;
hres = pSvc->ExecQuery(
bstr_t("WQL"),
bstr_t("SELECT * FROM Win32_SerialPort"), // 查询串口
WBEM_FLAG_FORWARD_ONLY | WBEM_FLAG_RETURN_IMMEDIATELY,
NULL,
&pEnumerator);
if (FAILED(hres)) {
std::cout << "Query for serial ports failed." << std::endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // 程序失败退出
}
// 遍历查询结果
IWbemClassObject *pclsObj = NULL;
ULONG uReturn = 0;
while (pEnumerator) {
HRESULT hr = pEnumerator->Next(WBEM_INFINITE, 1, &pclsObj, &uReturn);
if (0 == uReturn) {
break;
}
VARIANT vtProp;
// 获取端口名称
hr = pclsObj->Get(L"DeviceID", 0, &vtProp, 0, 0);
std::wcout << " COM Port : " << vtProp.bstrVal << std::endl;
VariantClear(&vtProp);
pclsObj->Release();
}
// 清理
pSvc->Release();
pLoc->Release();
pEnumerator->Release();
CoUninitialize();
return 0; // 程序成功退出
}
2.显示串口到控件
端口名字存储在 vtProp.bstrVal 中
// 获取组合框控件的指针
CComboBox* pComboBox = (CComboBox*)GetDlgItem(IDC_COMBOBOX);
pComboBox->AddString(CString(vtProp.bstrVal)); //添加端口名字到ComboBox
// 设置当前选中的项为第一个
pComboBox->SetCurSel(0);
3.界面显示
设备管理器中显示的串口:
mfc界面中检测到的串口: