FltGetNextExtraCreateParameter 函式 (fltkernel.h)

發行項
02/26/2024

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 值：

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