FltRemoveExtraCreateParameter 함수(fltkernel.h)

아티클
08/07/2023

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 루틴은 EcpList 매개 변수가 제공한 ECP 목록과 EcpType 매개 변수에서 제공하는 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