FltFindExtraCreateParameter 함수(fltkernel.h)

아티클
02/06/2025

FltFindExtraCreateParameter 루틴은 지정된 ECP 목록에서 지정된 형식의 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 컨텍스트 구조를 검색할 ECP 목록 구조체에 대한 포인터입니다(EcpType 매개 변수에서 제공됨).

[in] EcpType

각 ECP 컨텍스트 구조를 고유하게 식별하는 GUID에 대한 포인터입니다. 이 GUID 값은 FltFindExtraCreateParamter 루틴에서 ECP 컨텍스트 구조가 ECP 목록에 있는지 확인하는 데 사용됩니다(EcpList 매개 변수에서 지정).

[out, optional] EcpContext

찾은 ECP 컨텍스트 구조에 대한 포인터를 수신하는 선택적 매개 변수입니다. ECP 컨텍스트 구조가 ECP 목록에 없으면 EcpContext NULL 설정됩니다. EcpContext 호출자가 NULL 설정하면 이 루틴의 반환 값을 사용하여 ECP 컨텍스트 구조가 ECP 목록에 있는지 확인할 수 있습니다.

[out, optional] EcpContextSize

찾은 ECP 컨텍스트 구조의 크기(바이트)를 수신하는 선택적 매개 변수입니다. ECP 컨텍스트 구조가 ECP 목록에 없으면 EcpContextSize 0으로 설정됩니다.

반환 값

FltFindExtraCreateParameter 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드	묘사
STATUS_SUCCESS	ECP 컨텍스트 구조(EcpType 매개 변수로 지정됨)가 ECP 목록에서 발견되었습니다(EcpList 매개 변수로 지정됨).
STATUS_NOT_FOUND	ECP 컨텍스트 구조(EcpType 매개 변수로 지정됨)가 ECP 목록에 없습니다(EcpList 매개 변수로 지정됨).

요구 사항

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