FltFindExtraCreateParameter 함수(fltkernel.h)
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 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
ECP 컨텍스트 구조( EcpType 매개 변수로 지정됨)가 ECP 목록에서 발견되었습니다( EcpList 매개 변수로 지정됨). |
|
ECP 컨텍스트 구조( EcpType 매개 변수로 지정됨)가 ECP 목록에서 찾을 수 없습니다( EcpList 매개 변수로 지정됨). |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 이 루틴은 Windows Vista부터 사용할 수 있습니다. |
대상 플랫폼 | 유니버설 |
헤더 | fltkernel.h(Fltkernel.h 포함) |
라이브러리 | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
추가 정보
FltAllocateExtraCreateParameterFromLookasideList