FltGetFileContext 함수(fltkernel.h)

아티클
04/27/2023

FltGetFileContext 루틴은 지정된 미니필터 드라이버 instance 파일에 대해 설정된 컨텍스트를 검색합니다.

구문

NTSTATUS FLTAPI FltGetFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

매개 변수

[in] Instance

호출자에 대한 불투명 instance 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] FileObject

파일에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[out] Context

컨텍스트의 주소를 수신하는 호출자가 할당한 변수에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL로 설정할 수 없습니다.

반환 값

FltGetFileContext 는 요청된 파일 컨텍스트를 성공적으로 반환하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	설명
STATUS_NOT_FOUND	현재 이 파일에서 일치하는 컨텍스트를 찾을 수 없으므로 FltMgr은컨텍스트 를 NULL_CONTEXT 설정합니다. 오류 코드입니다.
STATUS_NOT_SUPPORTED	이 파일에는 파일 컨텍스트가 지원되지 않습니다. 오류 코드입니다.

설명

컨텍스트에 대한 자세한 내용은 미니필터 컨텍스트 정보를 참조하세요.

미니필터 드라이버는 FltGetFileContext 를 호출하여 지정된 파일에 대해 설정한 파일 컨텍스트를 검색합니다.

FltGetFileContext 는 Context 매개 변수가 가리키는 컨텍스트에 대한 참조 수를 증가합니다. 이 컨텍스트 포인터가 더 이상 필요하지 않은 경우 호출자는 FltReleaseContext를 호출하여 참조 횟수를 감소시켜야 합니다. 따라서 FltGetFileContext에 대한 모든 성공적인 호출은 FltReleaseContext에 대한 후속 호출과 일치해야 합니다.

파일 컨텍스트를 설정하려면 FltSetFileContext를 호출합니다.

새 컨텍스트를 할당하려면 FltAllocateContext를 호출합니다.

파일 컨텍스트를 삭제하려면 FltDeleteFileContext 또는 FltDeleteContext를 호출합니다.

지정된 파일에 대해 파일 컨텍스트가 지원되는지 여부를 확인하려면 FltSupportsFileContexts 또는 FltSupportsFileContextsEx를 호출합니다.

요구 사항

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