FltGetNextExtraCreateParameter 函式（fltkernel.h）

發行項
02/06/2025

FltGetNextExtraCreateParameter 例程會傳回指定 ECP 清單中下一個（或第一個）額外建立參數內容結構（ECP）的指標。

語法

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

參數

[in] Filter

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

[in] EcpList

要檢查之 ECP 清單的指標。

[in, optional] CurrentEcpContext

指定 ECP 清單中的 ECP 選擇性指標。如果存在，FltGetNextExtraCreateParameter 會在 CurrentEcpContext ECP 之後傳回 ECP。如果 currentEcpContext 為 NULL ，FltGetNextExtraCreateParameter 會傳回清單中的第一個 ECP。

[out, optional] NextEcpType

選擇性參數，接收傳回 ECP 之 GUID 的指標。

[out, optional] NextEcpContext

選擇性參數，接收傳回之 ECP 的指標。

[out, optional] NextEcpContextSize

選擇性參數，接收所傳回 ECP 的大小，以位元組為單位。

傳回值

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

傳回碼	描述
STATUS_SUCCESS	ecpList ECP 清單中找到 ECP。
STATUS_NOT_FOUND	EcpList ECP 清單是空的，或 CurrentEcpContext 是清單中最後一個 ECP，即沒有下一個 ECP 清單元素）。此外，NextEcpContext 會設定為 NULL，而 NextEcpContextSize 設定為零。
STATUS_INVALID_PARAMETER	EcpList 參數 NULL。

言論

從 Windows Vista 開始，即可使用此例程。

FltGetNextExtraCreateParameter 例程會以非迴圈方式處理 ECP 清單。也就是說，如果 CurrentEcpContext 參數所指向的 ECP 是 ECP 清單中的最後一個 ECP 元素，則清單中沒有 “next” ECP，而例程會傳回STATUS_NOT_FOUND。

要求

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