FltReleaseContext 함수(fltkernel.h)

아티클
08/07/2023

FltReleaseContext 는 컨텍스트에서 참조 수를 감소합니다.

구문

VOID FLTAPI FltReleaseContext(
  [in] PFLT_CONTEXT Context
);

매개 변수

[in] Context

컨텍스트에 대한 포인터입니다. 볼륨, instance, 스트림 또는 스트림 핸들에 대한 컨텍스트 개체에 대한 유효한 포인터여야 합니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

없음

설명

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

미니필터 드라이버는 FltReleaseContext 를 호출하여 컨텍스트를 해제합니다. FltReleaseContext 는 지정된 컨텍스트에서 참조 수를 감소합니다. 참조 수가 0에 도달하면 호출자가 IRQL <= APC_LEVEL 실행 중인 경우 컨텍스트가 즉시 해제됩니다. 호출자가 IRQL DISPATCH_LEVEL 실행 중인 경우 작업 항목이 컨텍스트를 해제하도록 예약됩니다.

참고

FltReleaseContext가 반환되면 컨텍스트가 이미 해제되었을 수 있으므로 호출자는 컨텍스트를 사용하지 않아야 합니다.

FltAllocateContext, FltGetXxxContext 또는 FltReferenceContext에 대한 모든 성공적인 호출은 결국 FltReleaseContext 호출과 일치해야 합니다.

FltSetXxxContext에서 반환된 OldContext 포인터와 FltDeleteContext를 호출하는 데 사용되는 Context 매개 변수도 더 이상 필요하지 않은 경우 FltReleaseContext를 호출하여 해제해야 합니다.

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

컨텍스트에서 참조 횟수를 증가하려면 FltReferenceContext를 호출합니다.

컨텍스트 참조 계산에 대한 자세한 내용은 컨텍스트 참조를 참조하세요.

컨텍스트가 비페이지 풀에서 할당된 경우 FltReleaseContext 의 호출자는 IRQL <= DISPATCH_LEVEL 실행되어야 합니다. 컨텍스트가 페이징 풀에서 할당된 경우 호출자는 IRQL <= APC_LEVEL 실행 중이어야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	fltkernel.h(Fltkernel.h 포함)
라이브러리	FltMgr.lib
DLL	Fltmgr.sys
IRQL	설명 섹션을 참조하십시오.