FltGetEcpListFromCallbackData 函数 (fltkernel.h)

FltGetEcpListFromCallbackData 例程返回指向与给定创建操作 callback-data 对象关联的 ECP) 列表的额外创建参数上下文 (结构的指针。

语法

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

参数

[in] Filter

指向微筛选器驱动程序的不透明筛选器指针。 此指针唯一标识微筛选器驱动程序,并且只要加载了微筛选器驱动程序,该指针就保持不变。

CallbackData

指向 FLT_CALLBACK_DATA类型的回调数据对象的指针,该对象表示创建操作。

[out] EcpList

接收指向与 CallbackData callback-data 对象关联的 ECP 列表的指针。

返回值

FltGetEcpListFromCallbackData 返回以下 NTSTATUS 值之一:

返回代码 说明
STATUS_SUCCESS
EcpList 收到指向与给定回调数据对象关联的 ECP 列表的指针。 如果 callback-data 对象没有关联的 ECP,则返回 STATUS_SUCCESS,EcpList NULL
STATUS_INVALID_PARAMETER
给定的回调数据对象不是基于 IRP 的创建操作。 在这种情况下, EcpList 是未定义的。

注解

若要将 ECP 列表附加到回调数据对象,请使用 FltSetEcpListIntoCallbackData 例程。

要求

要求
最低受支持的客户端 此例程从 Windows Vista 开始可用。
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

ECP_LIST

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx