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 方法。

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

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

typedef NTSTATUS
  EVT_SERCX_FILEOPEN(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;

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

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

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