FltSetEcpListIntoCallbackData 함수(fltkernel.h)

아티클
02/26/2024

FltSetEcpListIntoCallbackData 루틴은 추가 ECP(create 매개 변수 컨텍스트 구조) 목록을 create 작업 콜백 데이터 개체에 연결합니다.

구문

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 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	지정된 ECP 목록이 지정된 콜백 데이터 개체에 성공적으로 연결되었습니다.
STATUS_INVALID_PARAMETER_2	지정된 콜백 데이터 개체가 IRP 기반 만들기 작업이 아니었습니다.
STATUS_INVALID_PARAMETER_3	ECP 목록이 지정된 콜백 데이터 개체에 이미 연결되어 있습니다.

설명

FltSetEcpListIntoCallbackData 루틴은 파일 시스템 필터 스택 아래로 추가 만들기 매개 변수를 기본 미니필터 및 레거시 필터 드라이버에 전달하는 메커니즘을 제공합니다.

지정된 콜백 데이터 개체에서 연결된 ECP 목록을 검색하려면 FltGetEcpListFromCallbackData 루틴을 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	이 루틴은 Windows Vista부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	fltkernel.h(Fltkernel.h 포함)
라이브러리	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL