FltDeleteStreamHandleContext 함수(fltkernel.h)

아티클
02/04/2022
읽는 데 3분 걸림

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를 호출합니다.