WUDF_INTERRUPT_WORKITEM回调函数 (wudfinterrupt.h)
[警告: UMDF 2 是最新版本的 UMDF,并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]
驱动程序的 OnInterruptWorkItem 事件回调函数处理驱动程序的 OnInterruptIsr 回调函数存储的中断信息。
语法
WUDF_INTERRUPT_WORKITEM WudfInterruptWorkitem;
void WudfInterruptWorkitem(
[in] IWDFInterrupt *Interrupt,
[in] IWDFObject *AssociatedObject
)
{...}
参数
[in] Interrupt
指向与工作项关联的中断对象接口的指针。
[in] AssociatedObject
指向关联对象的指针。
返回值
无
备注
若要注册 OnInterruptWorkItem 回调函数,驱动程序必须在调用 IWDFDevice3::CreateInterrupt 之前将回调函数的地址置于 WUDF_INTERRUPT_CONFIG 结构中。
停止并确认中断后,驱动程序应从其 OnInterruptIsr 回调快速返回,从而推迟对 OnInterruptWorkItem 回调的任何其他处理。
有关在 UMDF 驱动程序中处理中断的详细信息,请参阅 访问硬件和处理中断。
示例
函数类型在 Wudfworkitem.h 中声明,如下所示。
typedef
_Function_class_(WUDF_INTERRUPT_WORKITEM)
VOID
WUDF_INTERRUPT_WORKITEM(
_In_
IWDFInterrupt* Interrupt,
_In_
IWDFObject* AssociatedObject
);
typedef WUDF_INTERRUPT_WORKITEM *PFN_WUDF_INTERRUPT_WORKITEM;
若要定义名为 MyInterruptWorkItem 的 OnInterruptWorkItem 回调函数,必须先提供 SDV 和其他验证工具所需的函数声明,如下所示:
WUDF_INTERRUPT_WORKITEM MyInterruptWorkItem;
然后,按如下所示实现回调函数:
VOID
MyInterruptWorkItem (
_In_
IWDFInterrupt* Interrupt,
_In_
IWDFObject* AssociatedObject
)
{…}
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.11 |
标头 | wudfinterrupt.h |