c# - 如何使用 EventWaitHandle 创建事件？

Question

我正在编写一个监听串行端口的程序。我已经有代码利用 VCP 驱动程序(虚拟 COM 端口)打开串行连接，然后为接收到的任何数据添加事件处理程序。该代码大致如下所示:

public void OpenPort(string portNumber)
{
    _port = new SerialPort(
        portName: portNumber,
        baudRate: 9600,
        parity: Parity.None,
        dataBits: 8,
        stopBits: StopBits.One
    );
    _port.DataReceived += ReadData;
}

private void ReadData(object sender, SerialDataReceivedEventArgs e)
{
    string data = _port.ReadExisting().Trim();
    Console.WriteLine("Received: " + data);
}

这很好用。我很容易理解如何使用 += 符号设置事件。但我正在尝试从使用 VCP 驱动程序切换到使用 D2XX drivers由 FTDI 提供。我有我需要编写的大部分等效代码，但值得注意的异常(exception)是在“数据接收”事件发生时能够读取数据。

D2XX 驱动程序包含一种用于在收到数据时设置事件处理程序的方法，称为 SetEventNotification。方法签名如下所示:

SetEventNotification(UInt32 eventMask, EventWaitHandle eventHandle);

第一个参数非常简单(它们有一些预定义的单位，您可以传入以确定事件何时触发)，但我以前从未直接使用过 EventWaitHandles，我发现了 the documentation很难掌握，所以我很难开始。

归根结底...我想要一个事件监听器方法来执行读取任务，并且我可以使用 += 运算符对其进行分配，就像我在上面所做的那样VCP 驱动程序。

根据我所阅读的内容，我似乎必须创建一个新的 Thread，它基本上会持续轮询 EventWaitHandle 的信号？或类似的东西？任何帮助我开始(或完成!)的示例或示例代码将不胜感激。

这是我目前所拥有的:

public void OpenPort(string portNumber)
{
    _port = new FTDI();
    var status = _port.OpenBySerialNumber(portNumber);
    if (FTDI.FT_STATUS.FT_OK != status) throw new Exception();

    status = _port.SetBaudRate((UInt32) 9600);
    if (FTDI.FT_STATUS.FT_OK != status) throw new Exception();

    status = _port.SetDataCharacteristics(
        DataBits: FTDI.FT_DATA_BITS.FT_BITS_8,
        StopBits: FTDI.FT_STOP_BITS.FT_STOP_BITS_1,
        Parity: FTDI.FT_PARITY.FT_PARITY_NONE
    );
    if (FTDI.FT_STATUS.FT_OK != status) throw new Exception();

    var evHandle = new EventWaitHandle(false, EventResetMode.AutoReset, "");
    _port.SetEventNotification(FTDI.FT_EVENTS.FT_EVENT_RXCHAR, evHandle);

    // ... now what?
}

public void ReadData(object sender, EventArgs e)
{
    UInt32 bytesAvailable = 0;
    _port.GetRxBytesAvailable(ref bytesAvailable);

    string data;
    UInt32 bytesRead = 0;
    _port.Read(out data, bytesAvailable, ref bytesRead);

    data = data.Trim();
    Console.WriteLine("Received: " + data);
}

Answer 1

I'll have to create a new Thread that essentially polls continuously for the EventWaitHandle's signal

民意调查，没有。但是等等，是的。事件句柄所能做的就是让线程休眠直到事件发出信号。请注意，此处的“事件”与 C#“事件”的含义完全不同，尽管您当然可以将前者用作后者实现的一部分。

坦率地说，您根本不清楚为什么要进行这一部分。您正在处理通过标准串行端口传输的数据吗？如果是这样，那么就永远不需要使用某些第三方 API； Windows 和 .NET 提供了您所需要的一切，您应该坚持使用它。使用此第三方 API 会给您带来哪些使用标准 SerialPort 类无法实现的好处？

就事件本身而言，没有更多上下文(不，不太可能有人会筛选您链接的 PDF 来弄清楚如何为您生成交 key 解决方案)，所有可以提供的都是一般性的概述如何使用事件句柄来实现事件:

public event EventHandler DataReceived;

private bool _done;

private void PortListener(EventWaitHandle waitHandle)
{
    while (true)
    {
        waitHandle.WaitOne();
        if (_done)
        {
            break;
        }

        EventHandler handler = DataReceived;

        if (handler != null)
        {
            handler(this, EventArgs.Empty);
        }
    }
}

public void StartListening(EventWaitHandle waitHandle)
{
    _done = false;
    new Thread(() => PortListener(waitHandle)).Start()
}

public void StopListening(EventWaitHandle waitHandle)
{
    _done = true;
    waitHandle.Set();
}

上面提供了一个 DataReceived C# 事件，只要等待句柄发出信号，就会引发该事件。它假设有一个自动重置事件。您也可以使用手动重置，只需(当然)在收到信号并引发 C# 事件时手动重置事件句柄。

为此，它只维护一个内部标志 _done 指示线程是否应该运行，并提供 Start... 和 Stop ... 方法，分别清除标志并启动线程循环，设置标志并向事件发出信号。