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호출하여 제거할 수 있습니다.

자세한 내용은 레거시 파일 시스템 필터 드라이버추적 Per-Stream 컨텍스트를 참조하세요.