FsRtlInsertPerStreamContext 함수(ntifs.h)

FsRtlInsertPerStreamContext 루틴은 파일 시스템 필터 드라이버의 스트림별 컨텍스트 구조를 파일 스트림과 연결합니다.

구문

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

PerStreamContext

파일 스트림의 FSRTL_ADVANCED_FCB_HEADER 구조체에 대한 포인터입니다. 파일 개체에서 이 포인터를 얻으려면 FsRtlGetPerStreamContextPointer 매크로를 사용합니다.

[in] Ptr

필터 드라이버가 할당하고 초기화한 FSRTL_PER_STREAM_CONTEXT 구조체에 대한 포인터입니다. 이 구조를 초기화하려면 FsRtlInitPerStreamContext 매크로를 사용합니다.

FsRtlInsertPerStreamContext 는 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	FsRtlInsertPerStreamContext에 대한 호출이 성공했습니다.
STATUS_INVALID_DEVICE_REQUEST	기본 파일 시스템은 필터 컨텍스트를 지원하지 않습니다.

파일 시스템 필터 드라이버는 FsRtlInsertPerStreamContext 를 호출하여 자체 스트림별 컨텍스트 구조를 파일 스트림과 연결합니다. 스트림별 컨텍스트 구조에는 필터 드라이버가 파일 스트림에 대해 유지 관리하는 컨텍스트 정보가 포함됩니다.

스트림별 컨텍스트 구조가 파일 스트림과 연결되면 FsRtlLookupPerStreamContext 를 호출하여 검색하거나 FsRtlRemovePerStreamContext를 호출하여 제거할 수 있습니다.