FltFindExtraCreateParameter 函式 (fltkernel.h)

發行項
02/29/2024

FltFindExtraCreateParameter 例程會搜尋指定類型的 ECP 內容結構清單，並在找到時傳回這個結構的指標。

語法

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

參數

[in] Filter

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

[in] EcpList

ECP 清單結構的指標，要在其中搜尋 EcpType 參數所指定 (ECP 內容結構) 。

[in] EcpType

可唯一識別每個 ECP 內容結構的 GUID 指標。 FltFindExtraCreateParamter 例程會使用此 GUID 值來判斷 ECP 內容結構是否存在於 ECP 清單中 (EcpList 參數所指定) 。

[out, optional] EcpContext

選擇性參數，可接收所找到 ECP 內容結構的指標。如果在 ECP 清單中找不到 ECP 內容結構， EcpContext 會設定為 NULL。如果呼叫端將 EcpContext 設定為 NULL ，則此例程的傳回值可用來判斷 ECP 內容結構是否位於 ECP 清單中。

[out, optional] EcpContextSize

選擇性參數，可接收所找到 ECP 內容結構的大小，以位元組為單位。如果在 ECP 清單中找不到 ECP 內容結構， EcpContextSize 會設定為零。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	ecpType 參數所指定的 ECP 內容結構 (，) 在 ECP 清單中找到 (，如 EcpList 參數所指定) 。
STATUS_NOT_FOUND	ecpType 參數所指定的 ECP 內容結構 () 在 ECP 清單中找不到 (如 EcpList 參數所指定) 。

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始，即可使用此例程。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	<= APC_LEVEL