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 |
另请参阅
PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK