FltGetEcpListFromCallbackData 函式 (fltkernel.h)

發行項
02/29/2024

FltGetEcpListFromCallbackData 例程會傳回與指定建立作業回呼數據對象相關聯的額外建立參數內容結構指標 (ECP) 清單。

語法

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

參數

[in] Filter

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

CallbackData

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

[out] EcpList

接收與 CallbackData 回 呼資料對象相關聯的 ECP 清單指標。

傳回值

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

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

備註

若要將 ECP 清單附加至回調數據物件，請使用 FltSetEcpListIntoCallbackData 例程。

規格需求

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