FltGetSectionContext 함수(fltkernel.h)

  • 아티클

FltGetSectionContext 루틴은 지정된 미니필터 드라이버 instance 파일 스트림에 대해 만들어진 섹션 컨텍스트를 검색합니다.

구문

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

매개 변수

[in] Instance

컨텍스트를 검색할 미니필터 드라이버 instance 대한 불투명 instance 포인터입니다.

[in] FileObject

스트림의 파일 개체에 대한 포인터입니다.

[out] Context

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

반환 값

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

반환 코드 설명
STATUS_NOT_FOUND 현재 이 파일에 일치하는 컨텍스트가 없으므로 FltMgr 은 컨텍스트 를 NULL_CONTEXT 설정합니다. 오류 코드입니다.
STATUS_NOT_SUPPORTED 이 instance 연결된 볼륨은 섹션 컨텍스트를 지원하지 않습니다. 오류 코드입니다.

설명

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

FltGetSectionContext는 지정된 미니필터 드라이버 instance 파일 스트림에 대해 만들어진 섹션 컨텍스트를 검색합니다. FltCreateSectionForDataScan을 호출하여 섹션 컨텍스트를 만듭니다.

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

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

미니필터는 FltCreateSectionForDataScan에 전달된 섹션 컨텍스트를 명시적으로 삭제해서는 안 됩니다. 이 경우 FltCloseSectionForDataScan 을 호출하여 섹션 컨텍스트가 할당 취소되고 스트림에서 제거됩니다.

요구 사항

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

추가 정보

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FltReleaseContext