共用方式為


FltInsertExtraCreateParameter 函式 (fltkernel.h)

FltInsertExtraCreateParameter 例程會將額外的建立參數 (ECP) 內容結構插入 ECP 清單中。

語法

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

參數

[in] Filter

迷你篩選驅動程式的不透明篩選指標。 此指標會唯一識別迷你篩選驅動程式,只要載入迷你篩選驅動程式,就會維持不變。

[in, out] EcpList

應該新增ecpContext 參數所提供ECP內容結構的ECP清單結構的指標。

[in, out] EcpContext

要新增至ECP清單的ECP內容結構的指標,由 EcpList 參數提供。

傳回值

FltInsertExtraCreateParameter 會傳回下列其中一個 NTSTATUS 值:

傳回碼 描述
STATUS_SUCCESS
指定的 ECP 內容結構已成功插入指定的 ECP 清單中。
STATUS_INVALID_PARAMETER
指定的 ECP 內容結構已存在於指定的 ECP 清單中。 在 ECP 清單插入的內容中,如果 ECP 內容結構包含相同的 GUID 值,則會將兩個 ECP 內容結構視為相同。

言論

FltInsertExtraCreateParameter 例程假設指定的 ECP 內容結構要插入指定的 ECP 清單之前是由 FltAllocateExtraCreateParameter 例程所配置。

插入 ECP 清單的每個 ECP 內容結構都必須有唯一的 GUID 值。 當 ECP 內容結構由 FltAllocateExtraCreateParameter 例程配置時,就會設定這個唯一值。

要求

要求 價值
最低支援的用戶端 從 Windows Vista 開始,即可使用此例程。
目標平臺 普遍
標頭 fltkernel.h (包括 Fltkernel.h)
連結庫 FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另請參閱

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx