FltGetNextExtraCreateParameter 함수(fltkernel.h)

아티클
08/07/2023

FltGetNextExtraCreateParameter 루틴은 지정된 ECP 목록의 다음(또는 첫 번째) 추가 ECP(만들기 매개 변수 컨텍스트 구조)에 대한 포인터를 반환합니다.

구문

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

매개 변수

[in] Filter

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

[in] EcpList

검사할 ECP 목록에 대한 포인터입니다.

[in, optional] CurrentEcpContext

지정된 ECP 목록의 ECP에 대한 선택적 포인터입니다. 있는 경우 FltGetNextExtraCreateParameter 는 CurrentEcpContext ECP 다음에 ECP를 반환합니다. CurrentEcpContext가 NULL이면 FltGetNextExtraCreateParameter는 목록의 첫 번째 ECP를 반환합니다.

[out, optional] NextEcpType

반환된 ECP의 GUID에 대한 포인터를 수신하는 선택적 매개 변수입니다.

[out, optional] NextEcpContext

반환된 ECP에 대한 포인터를 수신하는 선택적 매개 변수입니다.

[out, optional] NextEcpContextSize

반환된 ECP의 크기(바이트)를 수신하는 선택적 매개 변수입니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	ECP가 EcpList ECP 목록에서 발견되었습니다.
STATUS_NOT_FOUND	EcpList ECP 목록이 비어 있거나 CurrentEcpContext가 목록의 마지막 ECP입니다. 즉, 다음 ECP 목록 요소가 없습니다.) 또한 NextEcpContext 는 NULL 로 설정되고 NextEcpContextSize 는 0으로 설정됩니다.
STATUS_INVALID_PARAMETER	EcpList 매개 변수는 NULL입니다.

설명

이 루틴은 Windows Vista부터 사용할 수 있습니다.

FltGetNextExtraCreateParameter 루틴은 순환이 아닌 방식으로 ECP 목록을 처리합니다. 즉, CurrentEcpContext 매개 변수가 가리키는 ECP가 ECP 목록의 마지막 ECP 요소인 경우 목록에 "다음" ECP가 없고 루틴이 STATUS_NOT_FOUND 반환합니다.

요구 사항

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