FltRemoveExtraCreateParameter 函式 (fltkernel.h)

發行項
02/26/2024

FltRemoveExtraCreateParameter 例程會搜尋 ECP 內容結構的 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

額外 create 參數的指標 (ECP) 清單，其中包含要從指定清單卸離的 ECP 內容結構。

[in] EcpType

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

[out] EcpContext

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

[out, optional] EcpContextSize

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

傳回值

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

傳回碼	Description
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 開始可供使用。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	<= APC_LEVEL