如何使用 EventWaitHandle 创建事件?

How can I use EventWaitHandle to create an event?

我正在编写一个在串行端口上侦听的程序。我已经有代码利用 VCP drivers(虚拟 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 drivers 切换到使用 FTDI 提供的 D2XX drivers。我有我需要编写的大部分等效代码,除了在 "data received" 事件发生时能够读取数据这一显着例外。

D2XX driver 包括一种在收到数据时设置事件处理程序的方法,称为 SetEventNotification。方法签名如下所示:

SetEventNotification(UInt32 eventMask, EventWaitHandle eventHandle);

第一个参数 straight-forward 就足够了(它们有一些预定义的 uint,你可以传入以确定事件何时触发),但我以前从未直接使用过 EventWaitHandles,我发现 the documentation 很难掌握,所以我很难开始。

归根结底...我想要一个事件侦听器方法来执行读取任务,并且我可以使用 += 运算符分配它,就像我在上面对 VCP 所做的那样driver.

根据我读到的内容,看来我必须创建一个新的 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);
}

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

民意调查,没有。但是等等,是的。事件句柄所能做的就是让线程休眠直到事件发出信号。请注意,这里的 "event" 与 C# "event" 完全不同,当然您可以将前者用作后者实现的一部分。

坦率地说,完全不清楚您为什么要了解这一部分。您正在处理通过标准串行端口传输的数据吗?如果是这样,那么就永远不需要使用第三方 API; Windows 和 .NET 提供了您所需要的一切,您应该坚持使用它。使用此第三方 API 有什么好处是您使用标准 SerialPort class 无法实现的?

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

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...方法,分别清除标志并启动线程循环,设置标志并向事件发出信号。