EVT_SERCX2_FILECLOSE回调函数 (sercx.h)
串行框架扩展版本 2 调用 EvtSerCx22FileClose 事件回调函数 (SerCx2) ,以通知串行控制器驱动程序客户端发布了表示与串行控制器设备的逻辑连接的文件对象。
语法
EVT_SERCX2_FILECLOSE EvtSercx2Fileclose;
void EvtSercx2Fileclose(
[in] WDFDEVICE Device
)
{...}
参数
[in] Device
表示串行控制器的框架设备对象的 WDFDEVICE 句柄。 串行控制器驱动程序在其 EvtDriverDeviceAdd 回调函数中创建此对象。 有关详细信息,请参阅 SerCx2InitializeDevice。
返回值
无
备注
串行控制器驱动程序可以选择实现此函数。 如果实现,驱动程序会在对 SerCx2InitializeDevice 方法的调用中注册此函数,该方法完成串行控制器的框架设备对象的初始化。
有关详细信息,请参阅 框架文件对象。
示例
若要定义 EvtSerCx2FileClose 回调函数,必须首先提供一个函数声明,用于标识要定义的回调函数的类型。 Windows 为驱动程序提供了一组回调函数类型。 使用回调函数类型声明函数可帮助 驱动程序的代码分析、 静态驱动程序验证程序 (SDV) 和其他验证工具查找错误,这是为 Windows 操作系统编写驱动程序的要求。
例如,若要定义名为 MyFileClose
的 EvtSerCx2FileClose 回调函数,请使用 EVT_SERCX2_FILECLOSE 函数类型,如以下代码示例所示:
EVT_SERCX2_FILECLOSE MyFileClose;
然后,按如下所示实现回调函数:
_Use_decl_annotations_
VOID
MyFileClose(
WDFDEVICE Device
)
{...}
EVT_SERCX2_FILECLOSE函数类型在 Sercx.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误,请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations批注可确保使用应用于头文件中EVT_SERCX2_FILECLOSE函数类型的注释。 有关函数声明要求的详细信息,请参阅 使用 KMDF 驱动程序的函数角色类型声明函数。 有关 Use_decl_annotations的详细信息,请参阅 批注函数行为。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从Windows 8.1开始可用。 |
目标平台 | 桌面 |
标头 | sercx.h |
IRQL | 在 IRQL <= DISPATCH_LEVEL 调用。 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈