FltInsertExtraCreateParameter 函式 (fltkernel.h)

FltInsertExtraCreateParameter 例程會將額外的 create 參數 (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 值：

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

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

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