fltGetContexts 函数 (fltkernel.h)

FltGetContexts 例程检索与当前操作相关的对象的微筛选器驱动程序上下文。

语法

VOID FLTAPI FltGetContexts(
  PCFLT_RELATED_OBJECTS FltObjects,
  FLT_CONTEXT_TYPE      DesiredContexts,
  PFLT_RELATED_CONTEXTS Contexts
);

参数

FltObjects

[in]指向 FLT_RELATED_OBJECTS 结构的指针，该结构包含与当前操作相关的对象的不透明指针。 有关此参数的详细信息，请参阅“备注”部分。

DesiredContexts

[in]标识要检索的上下文类型。 此参数可以是以下值的按位 OR。

常数	Value
FLT_VOLUME_CONTEXT	0x0001
FLT_INSTANCE_CONTEXT	0x0002
FLT_FILE_CONTEXT	0x0004
FLT_STREAM_CONTEXT	0x0008
FLT_STREAMHANDLE_CONTEXT	0x0010
FLT_TRANSACTION_CONTEXT	0x0020
从 Windows 8) 开始FLT_SECTION_CONTEXT (	020040
FLT_ALL_CONTEXTS	所有上下文值的按位 OR

Contexts

[out]指向调用方分配 的FLT_RELATED_CONTEXTS 结构的指针，该结构接收请求的上下文。 此参数是必需的，不能设置为 NULL。 FltMgr 将结构成员设置为零：

• 调用方未请求的上下文。
• 调用方请求但 FltMgr 找不到的上下文。

返回值

无。

备注

有关上下文的详细信息，请参阅 关于微筛选器上下文。

微筛选器驱动程序调用 FltGetContexts 来检索指向 FLT_RELATED_OBJECTS 结构中对象的微筛选器驱动程序上下文的指针。

以下微筛选器驱动程序回调例程类型接收指向 FLT_RELATED_OBJECTS 结构的指针作为 FltObjects 输入参数：

• PFLT_PRE_OPERATION_CALLBACK
• PFLT_POST_OPERATION_CALLBACK
• PFLT_INSTANCE_SETUP_CALLBACK
• PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK
• PFLT_INSTANCE_TEARDOWN_CALLBACK

FltGetContexts 递增 contexts 参数指向的FLT_RELATED_CONTEXTS结构中返回的每个上下文的引用计数。 因此，对于每次成功调用 FltGetContexts，调用方必须：

• 为 Contexts 参数指向的整个结构调用 FltReleaseContexts。
• 为结构中返回的每个上下文调用 FltReleaseContext ，并将结构中返回的每个上下文字段设置为零。

要求

要求	值
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

另请参阅

FLT_RELATED_CONTEXTS

FLT_RELATED_OBJECTS

FltGetContextsEx

FltRegisterFilter

FltReleaseContext

FltReleaseContexts

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK

PFLT_INSTANCE_SETUP_CALLBACK

PFLT_INSTANCE_TEARDOWN_CALLBACK

PFLT_POST_OPERATION_CALLBACK

PFLT_PRE_OPERATION_CALLBACK