FltRemoveExtraCreateParameter 函式（fltkernel.h）

發行項
02/06/2025

FltRemoveExtraCreateParameter 例程會搜尋 ECP 內容結構，如果找到，則會將其與 ECP 清單中斷連結。

語法

NTSTATUS FLTAPI FltRemoveExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in, out]       PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out]           PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

參數

[in] Filter

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

[in, out] EcpList

額外建立參數（ECP）清單的指標，其中包含要與指定清單中斷連結的 ECP 內容結構。

[in] EcpType

使用者定義 GUID 的指標，可唯一識別要從清單中卸離的 ECP 內容結構。

[out] EcpContext

卸離 ECP 內容結構的指標。如果 ECP 內容結構已成功與指定清單中斷連結，此參數將會設定為指向已中斷連結的 ECP 內容結構。如果指定的 ECP 清單中找不到 ECP 內容結構，此參數會設定為 NULL。

[out, optional] EcpContextSize

選擇性參數，可接收卸離 ECP 內容結構的大小。如果呼叫例程時存在此參數，參數將會收到卸離 ECP 內容結構的大小，以位元組為單位。如果在指定的 ECP 清單中找不到指定的 ECP 內容結構，這個參數是未定義的。

傳回值

FltRemoveExtraCreateParameter 會傳回下列其中一個 NTSTATUS 值：

傳回碼	描述
STATUS_SUCCESS	指定的 ECP 內容結構已成功與指定的 ECP 清單中斷連結。
STATUS_NOT_FOUND	在指定的 ECP 清單中找不到指定的 ECP 內容結構。

言論

FltRemoveExtraCreateParameter 例程會搜尋 EcpList 參數所指定的 ECP 清單，以取得由 EcpType 參數所指定的 ECP 內容結構。如果清單中存在ECP內容結構，則會從清單中中斷連結，則會將 EcpContext 參數設定為指向它，而例程會傳回STATUS_SUCCESS。如果清單中沒有ECP內容結構，EcpContext 參數會設定為 NULL，而例程會傳回STATUS_NOT_FOUND。

注意此例程不會釋放 ECP 內容結構的記憶體集區。若要釋放 ECP 內容結構，請先呼叫此例程以將它與清單中斷連結，然後呼叫 FltFreeExtraCreateParameter 例程釋放 ECP 內容結構本身。

要求

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