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 |