FltRemoveExtraCreateParameter 함수(fltkernel.h)

아티클
02/06/2025

FltRemoveExtraCreateParameter 루틴은 ECP 목록의 ECP 컨텍스트 구조를 검색하고 있는 경우 ECP 목록에서 분리합니다.

통사론

NTSTATUS FLTAPI FltRemoveExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in, out]       PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out]           PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

매개 변수

[in] Filter

미니 필터 드라이버에 대한 불투명 필터 포인터입니다. 이 포인터는 미니 필터 드라이버를 고유하게 식별하고 미니 필터 드라이버가 로드되는 한 일정하게 유지됩니다.

[in, out] EcpList

지정된 목록에서 분리할 ECP 컨텍스트 구조를 포함하는 ECP(추가 만들기 매개 변수) 목록에 대한 포인터입니다.

[in] EcpType

목록에서 분리할 ECP 컨텍스트 구조를 고유하게 식별하는 사용자 정의 GUID에 대한 포인터입니다.

[out] EcpContext

분리된 ECP 컨텍스트 구조에 대한 포인터입니다. ECP 컨텍스트 구조가 지정된 목록에서 성공적으로 분리된 경우 이 매개 변수는 분리된 ECP 컨텍스트 구조를 가리키도록 설정됩니다. 지정된 ECP 목록에서 ECP 컨텍스트 구조를 찾을 수 없는 경우 이 매개 변수는 NULL 설정됩니다.

[out, optional] EcpContextSize

분리된 ECP 컨텍스트 구조의 크기를 받는 선택적 매개 변수입니다. 루틴이 호출될 때 이 매개 변수가 있는 경우 매개 변수는 분리된 ECP 컨텍스트 구조의 크기(바이트)를 받습니다. 지정된 ECP 컨텍스트 구조를 지정된 ECP 목록에서 찾을 수 없는 경우 이 매개 변수는 정의되지 않습니다.

반환 값

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

반환 코드	묘사
STATUS_SUCCESS	지정된 ECP 컨텍스트 구조가 지정된 ECP 목록에서 성공적으로 분리되었습니다.
STATUS_NOT_FOUND	지정된 ECP 컨텍스트 구조가 지정된 ECP 목록에서 찾을 수 없습니다.

발언

FltRemoveExtraCreateParameter 루틴은 EcpType 매개 변수에서 제공하는 ECP 컨텍스트 구조에 대해 EcpList 매개 변수에서 제공하는 ECP 목록을 검색합니다. ECP 컨텍스트 구조가 목록에 있으면 목록에서 분리되고 EcpContext 매개 변수가 해당 매개 변수를 가리키도록 설정되며 루틴은 STATUS_SUCCESS 반환합니다. ECP 컨텍스트 구조가 목록에 없으면 EcpContext 매개 변수가 NULL 설정되고 루틴은 STATUS_NOT_FOUND 반환합니다.

참고 이 루틴은 ECP 컨텍스트 구조에 대한 메모리 풀을 해제하지 않습니다. ECP 컨텍스트 구조를 해제하려면 먼저 이 루틴을 호출하여 목록에서 분리한 다음 FltFreeExtraCreateParameter 루틴을 호출하여 ECP 컨텍스트 구조 자체를 해제합니다.

요구 사항

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