FltDeleteStreamHandleContext 함수(fltkernel.h)
fltDeleteStreamHandleContext 지정된 스트림 핸들에 대해 지정된 미니 필터 드라이버 인스턴스가 설정한 컨텍스트를 제거하고 삭제 컨텍스트를 표시합니다.
통사론
NTSTATUS FLTAPI FltDeleteStreamHandleContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PFLT_CONTEXT *OldContext
);
매개 변수
[in] Instance
스트림 핸들에 연결된 컨텍스트 목록에서 컨텍스트를 제거할 미니 필터 드라이버 인스턴스에 대한 불투명 인스턴스 포인터입니다.
[in] FileObject
파일 스트림의 파일 개체에 대한 포인터입니다.
[out] OldContext
삭제된 컨텍스트의 주소를 받는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다. OldContext NULL 않고 NULL_CONTEXT 가리키지 않는 경우 호출자는 더 이상 필요하지 않은 경우 FltReleaseContext 호출하여 이 컨텍스트를 해제할 책임이 있습니다.
반환 값
FltDeleteStreamHandleContext STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| STATUS_FLT_DELETING_OBJECT | 지정된 인스턴스 삭제되고 있습니다. 오류 코드입니다. |
| STATUS_NOT_FOUND | 일치하는 컨텍스트를 찾을 수 없습니다. 오류 코드입니다. |
| STATUS_NOT_SUPPORTED | 파일 시스템은 이 파일 스트림 핸들에 대한 스트림별 컨텍스트를 지원하지 않습니다. 오류 코드입니다. |
발언
컨텍스트에 대한 자세한 내용은 미니 필터 컨텍스트 정보참조하세요.
컨텍스트는 참조 계산되므로 일반적으로 미니 필터 드라이버가 FltDeleteStreamHandleContext 같은 루틴을 호출하여 컨텍스트를 명시적으로 삭제할 필요는 없습니다.
미니 필터 드라이버는 FltDeleteStreamHandleContext 호출하여 스트림 핸들에서 컨텍스트를 제거하고 삭제할 컨텍스트를 표시합니다. 컨텍스트에 대한 미해결 참조가 없는 한 컨텍스트는 일반적으로 즉시 해제됩니다(예: 컨텍스트가 다른 스레드에서 계속 사용 중이기 때문).
새 컨텍스트를 할당하려면 FltAllocateContext호출합니다.
스트림 컨텍스트를 얻으려면 FltGetStreamHandleContext호출합니다.
스트림 컨텍스트를 설정하려면 FltSetStreamHandleContext호출합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | fltkernel.h(Fltkernel.h 포함) |
| 라이브러리 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |