fltDeleteVolumeContext 函数 (fltkernel.h)
FltDeleteVolumeContext 删除给定微筛选器驱动程序为给定卷设置的上下文,并标记要删除的上下文。
语法
NTSTATUS FLTAPI FltDeleteVolumeContext(
[in] PFLT_FILTER Filter,
[in] PFLT_VOLUME Volume,
[out, optional] PFLT_CONTEXT *OldContext
);
参数
[in] Filter
调用方不透明的筛选器指针。
[in] Volume
卷的不透明卷指针。
[out, optional] OldContext
指向调用方分配的变量的指针,该变量接收已删除上下文的地址。 此参数是可选的,可以为 NULL。 如果 OldContext 不为 NULL 且未指向NULL_CONTEXT,则调用方负责调用 FltReleaseContext 以在不再需要时释放此上下文。
返回值
FltDeleteVolumeContext 返回STATUS_SUCCESS或相应的 NTSTATUS 值,如以下值之一:
返回代码 | 说明 |
---|---|
STATUS_FLT_DELETING_OBJECT | 指定的 卷 正在被拆掉。 这是错误代码。 |
STATUS_NOT_FOUND | 找不到匹配的上下文。 这是错误代码。 |
注解
有关上下文的详细信息,请参阅 关于微筛选器上下文。
由于上下文是引用计数的,因此微筛选器驱动程序通常不需要调用例程(如 FltDeleteVolumeContext )来显式删除上下文。
微筛选器驱动程序调用 FltDeleteVolumeContext 以从卷中删除上下文并标记要删除的上下文。 上下文通常立即释放,除非 (存在未完成的引用,例如,因为上下文仍由另一个线程) 使用。
若要分配新上下文,请调用 FltAllocateContext。
若要获取卷上下文,请调用 FltGetVolumeContext。
若要设置卷上下文,请调用 FltSetVolumeContext。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | fltkernel.h (包括 Fltkernel.h) |
Library | FltMgr.lib |
IRQL | <= APC_LEVEL |