fltFindExtraCreateParameter 函数 (fltkernel.h)
FltFindExtraCreateParameter 例程在给定 ECP 列表中搜索给定类型的 ECP 上下文结构,并在找到该结构时返回指向此结构的指针。
语法
NTSTATUS FLTAPI FltFindExtraCreateParameter(
[in] PFLT_FILTER Filter,
[in] PECP_LIST EcpList,
[in] LPCGUID EcpType,
[out, optional] PVOID *EcpContext,
[out, optional] ULONG *EcpContextSize
);
参数
[in] Filter
微型筛选器驱动程序的不透明筛选器指针。 此指针唯一标识微型筛选器驱动程序,只要加载微型筛选器驱动程序,该指针将保持不变。
[in] EcpList
指向 ECP 列表结构的指针,在该结构中搜索 ecpType 参数) 给定的 ECP 上下文结构 (。
[in] EcpType
指向唯一标识每个 ECP 上下文结构的 GUID 的指针。 FltFindExtraCreateParamter 例程使用此 GUID 值来确定 ECP 上下文结构是否存在于 ECP 列表中 (EcpList 参数) 。
[out, optional] EcpContext
接收指向找到的 ECP 上下文结构的指针的可选参数。 如果在 ECP 列表中找不到 ECP 上下文结构, 则 EcpContext 设置为 NULL。 如果调用方将 EcpContext 设置为 NULL ,则可以使用此例程的返回值来确定 ECP 上下文结构是否位于 ECP 列表中。
[out, optional] EcpContextSize
可选参数,用于接收找到的 ECP 上下文结构的大小(以字节为单位)。 如果在 ECP 列表中找不到 ECP 上下文结构, 则 EcpContextSize 设置为零。
返回值
FltFindExtraCreateParameter 返回以下 NTSTATUS 值之一:
返回代码 | 说明 |
---|---|
|
ecpType 参数) 指定的 ECP 上下文结构 (在 ecpList 参数) 指定的 ECP 列表中找到 (。 |
|
ecpType 参数) 指定的 ECP 上下文结构 (未在 ecpList 参数) 指定的 ECP 列表中 (找到。 |
要求
最低受支持的客户端 | 此例程从 Windows Vista 开始可用。 |
目标平台 | 通用 |
标头 | fltkernel.h (包括 Fltkernel.h) |
Library | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
另请参阅
FltAllocateExtraCreateParameterFromLookasideList