在C++/WinRT中如何跨函数调用WriteValueWithResultAsync写入BLE特征值

针对你在C++ MFC + C++/WinRT环境下无法全局访问BLE特征对象的问题，以下是几种实用方案：

方案1：使用类成员变量（推荐，符合MFC面向对象设计） #

将GattCharacteristic声明为MFC窗口类或BLE管理类的成员变量，这样所有成员函数都能直接访问，避免全局变量的弊端。

示例代码： #

1. 头文件中声明成员变量

#include <winrt/Windows.Devices.Bluetooth.GenericAttributeProfile.h>

class CMyMFCDialog : public CDialogEx
{
    // ... 其他类成员
private:
    // 声明BLE TX特征对象，默认是空状态（等价于nullptr）
    winrt::Windows::Devices::Bluetooth::GenericAttributeProfile::GattCharacteristic m_txCharacteristic;
public:
    void EnumerateBLECharacteristics(); // 枚举BLE特征的函数
    winrt::fire_and_forget WriteToBLEAsync(const winrt::hstring& data); // 异步写入函数
};

2. cpp文件中赋值与使用

void CMyMFCDialog::EnumerateBLECharacteristics()
{
    // ... 省略设备查找、服务枚举逻辑
    // 找到目标TX特征后直接赋值
    m_txCharacteristic = txCharacteristic;
}

winrt::fire_and_forget CMyMFCDialog::WriteToBLEAsync(const winrt::hstring& data)
{
    // 先判断特征是否有效
    if (!m_txCharacteristic)
    {
        AfxMessageBox(_T("BLE TX特征未初始化"));
        co_return;
    }

    // 构造写入数据
    winrt::Windows::Storage::Streams::DataWriter writer;
    writer.UnicodeEncoding(winrt::Windows::Storage::Streams::UnicodeEncoding::Utf8);
    writer.WriteString(data);

    // 执行异步写入
    auto status = co_await m_txCharacteristic.WriteValueWithResultAsync(
        writer.DetachBuffer(),
        winrt::Windows::Devices::Bluetooth::GenericAttributeProfile::GattWriteOption::WriteWithoutResponse);

    // 处理写入结果
    if (status.Status() != winrt::Windows::Devices::Bluetooth::GenericAttributeProfile::GattCommunicationStatus::Success)
    {
        AfxMessageBox(_T("BLE写入失败"));
    }
}

方案2：全局变量（不推荐，但适合快速验证） #

如果必须使用全局变量，需要通过extern声明实现跨文件访问：

示例代码： #

1. 公共头文件（如BLEHelper.h）

#pragma once
#include <winrt/Windows.Devices.Bluetooth.GenericAttributeProfile.h>

// 声明全局特征对象
extern winrt::Windows::Devices::Bluetooth::GenericAttributeProfile::GattCharacteristic g_txCharacteristic;

2. cpp文件（如BLEHelper.cpp）定义全局变量

#include "BLEHelper.h"

// 定义全局特征对象，默认是空状态
winrt::Windows::Devices::Bluetooth::GenericAttributeProfile::GattCharacteristic g_txCharacteristic;

3. 赋值与使用
   在枚举特征的函数中赋值：

void EnumerateBLE()
{
    // ... 省略枚举逻辑
    g_txCharacteristic = txCharacteristic;
}

在其他函数中直接调用：

winrt::fire_and_forget WriteToBLEGlobal(const winrt::hstring& data)
{
    if (!g_txCharacteristic) return;
    // 写入逻辑同方案1
}

方案3：容器存储（适合多特征管理） #

如果需要管理多个BLE特征，可以用std::vector存储特征对象，后续通过UUID或其他标识定位目标特征。

示例代码： #

// 类成员声明
std::vector<winrt::Windows::Devices::Bluetooth::GenericAttributeProfile::GattCharacteristic> m_bleCharacteristics;

// 枚举时存入容器
void EnumerateBLECharacteristics()
{
    // ... 遍历服务的所有特征
    for (auto const& chara : service.GetCharacteristics())
    {
        m_bleCharacteristics.push_back(chara);
        // 可选：单独存储TX特征，方便快速访问
        if (chara.Uuid() == winrt::guid{L"你的TX特征UUID"})
        {
            m_txCharacteristic = chara;
        }
    }
}

// 通过UUID查找特征并写入
winrt::fire_and_forget WriteByUuid(const winrt::guid& charUuid, const winrt::hstring& data)
{
    auto it = std::find_if(m_bleCharacteristics.begin(), m_bleCharacteristics.end(),
        [&charUuid](const auto& chara) { return chara.Uuid() == charUuid; });

    if (it == m_bleCharacteristics.end())
    {
        AfxMessageBox(_T("未找到指定特征"));
        co_return;
    }

    // 写入逻辑同方案1
    auto status = co_await it->WriteValueWithResultAsync(...);
}

关键注意事项 #

1. WinRT对象特性：GattCharacteristic是C++/WinRT的智能封装类型，默认是空状态，无需提前创建"空对象"，直接赋值即可自动管理引用计数。
2. 静态变量未定义问题：如果之前尝试类静态成员失败，是因为未在cpp文件中定义静态变量，需补充：winrt::GattCharacteristic CMyMFCDialog::m_txCharacteristic;
3. 线程安全：异步写入操作WriteValueWithResultAsync会切换线程，若需在UI线程处理结果，可使用co_await winrt::resume_foreground(m_hWnd);回到UI上下文。

内容的提问来源于stack exchange，提问作者ehardin