EVT_SERCX_FILEOPEN回调函数（sercx.h）

EvtSerCxFileOpen 事件回调函数通知串行控制器驱动程序客户端在串行控制器设备上打开文件句柄，以及已创建文件对象来表示设备。

语法

EVT_SERCX_FILEOPEN EvtSercxFileopen;

NTSTATUS EvtSercxFileopen(
  [in] WDFDEVICE Device
)
{...}

[in] Device

表示串行控制器的框架设备对象的 WDFDEVICE 句柄。

如果调用成功，则 EvtSerCxFileOpen 函数返回STATUS_SUCCESS。否则，它将返回适当的错误状态代码。

串行框架扩展（SerCx）调用此函数来准备串行控制器硬件以接受 I/O 操作的请求。此函数应将控制器配置为准备好接收和传输数据的状态。如果需要中断，此函数应启用中断。此外，此函数应分配仅在文件对象的生存期内所需的任何内存。例如，此函数可以分配中断数据缓冲区。

若要注册 EvtSerCxFileOpen 回调函数，驱动程序必须调用 SerCxInitialize 方法。

有关详细信息，请参阅 Framework 文件对象。

此回调的函数类型在 Sercx.h 中声明，如下所示。

typedef NTSTATUS
  EVT_SERCX_FILEOPEN(
    __in WDFDEVICE Device
    );

若要定义名为 MyEvtSerCxFileOpen的 EvtSerCxFileOpen 回调函数，必须先提供静态驱动程序验证程序（SDV）和其他验证工具所需的函数声明，如下所示。

EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;

然后，按如下所示实现回调函数。

NTSTATUS
  MyEvtSerCxFileOpen(
    __in WDFDEVICE Device
    )
{ ... }

有关函数声明的 SDV 要求的详细信息，请参阅使用 KMDF 驱动程序的函数角色类型声明函数。