FltGetEcpListFromCallbackData 函式（fltkernel.h）

發行項
02/06/2025

FltGetEcpListFromCallbackData 例程會傳回與指定建立作業 callback-data 對象相關聯的額外建立參數內容結構（ECP）清單指標。

語法

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

參數

[in] Filter

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

CallbackData

類型為 FLT_CALLBACK_DATA之 callback-data 物件的指標，表示建立作業。

[out] EcpList

接收與 CallbackData 相關聯的 ECP 清單指標， callback-data 物件。

傳回值

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

傳回碼	描述
STATUS_SUCCESS	EcpList 收到與指定回呼數據對象相關聯的 ECP 清單指標。如果 callback-data 物件沒有相關聯的 ECP，則會傳回STATUS_SUCCESS，且 EcpList NULL。
STATUS_INVALID_PARAMETER	指定的回呼數據物件不是以 IRP 為基礎的建立作業。在此情況下，未定義 EcpList。

言論

若要將ECP清單附加至 callback-data 物件，請使用 FltSetEcpListIntoCallbackData 例程。

要求

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