FltSetEcpListIntoCallbackData 函式 (fltkernel.h)

發行項
02/26/2024

FltSetEcpListIntoCallbackData 例程會將額外的 create 參數內容結構附加 (ECP) 列表，以建立作業回呼數據物件。

語法

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

參數

[in] Filter

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

CallbackData

類型為 FLT_CALLBACK_DATA 的回調數據物件的指標，代表建立作業。

[in] EcpList

要附加至回調數據物件的ECP清單指標，其中包含一或多個ECP。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	指定的 ECP 清單已成功附加至指定的回調資料物件。
STATUS_INVALID_PARAMETER_2	指定的回呼數據物件不是以 IRP 為基礎的建立作業。
STATUS_INVALID_PARAMETER_3	ECP 清單已經附加至指定的回調數據物件。

備註

FltSetEcpListIntoCallbackData 例程提供一種機制，可將額外的建立參數傳遞至文件系統篩選堆棧，以傳遞至基礎迷你篩選和舊版篩選驅動程式。

若要從指定的回調數據物件擷取附加的ECP清單，請使用 FltGetEcpListFromCallbackData 例程。

規格需求

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