EXT_DELETE_PARAMETERS结构(wdm.h)
EXT_DELETE_PARAMETERS 结构包含 ExDeleteTimer 例程的扩展参数集。
语法
typedef struct _EXT_DELETE_PARAMETERS {
ULONG Version;
ULONG Reserved;
PEXT_DELETE_CALLBACK DeleteCallback;
PVOID DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;
成员
Version
此 EXT_DELETE_PARAMETERS 结构的版本号。 ExInitializeDeleteTimerParameters 例程将此成员设置为正确的版本号。
Reserved
设置为零。 ExInitializeDeleteTimerParameters 例程将此成员设置为零。
DeleteCallback
指向驱动程序实现的 ExTimerDeleteCallback 回调例程的指针。 删除计时器时,作系统会调用此例程。 此参数是可选的,如果需要计时器删除回调例程,则可以 NULL。
ExInitializeDeleteTimerParameters 例程将此成员设置为 NULL。 有关详细信息,请参阅“备注”。
DeleteContext
计时器删除回调例程的上下文值。 如果指定了计时器删除回调例程,作系统会将此值作为参数传递给计时器删除回调例程。 此参数通常是指向调用方定义的结构的指针,其中包含回调例程使用的上下文信息。 此参数是可选的,如果不需要上下文信息,则可以设置为 NULL。
ExInitializeDeleteTimerParameters 例程将此成员设置为 NULL。
言论
ExDeleteTimer 例程的 Parameters 参数是指向 EXT_DELETE_PARAMETERS 结构的指针。 将 EXT_DELETE_PARAMETERS 结构传递给此例程之前,请调用 ExInitializeDeleteTimerParameters 例程来初始化结构。
驱动程序可以使用 ExTimerDeleteCallback 回调例程释放驱动程序以前可能已分配给与正在删除的计时器对象一起使用的任何存储或其他系统资源。 例如,如果删除计时器对象,驱动程序的上下文值可能指向需要释放的调用方分配的结构。 只有在禁用计时器对象后,作系统才会调用 ExTimerDeleteCallback 例程,以防止进一步的计时器作,并且计时器对象上的任何挂起的计时器作被取消或完成。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 8.1 开始支持。 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |