wdm.h) (EXT_DELETE_PARAMETERS 结构
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) |