FsRtlLookupPerStreamContext 매크로(ntifs.h)

아티클
03/08/2023

FsRtlLookupPerStreamContext 매크로는 파일 스트림에 대한 스트림별 컨텍스트 구조를 검색합니다.

구문

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

매개 변수

_sc

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

_oid

스트림별 컨텍스트 구조의 소유자를 고유하게 식별하는 호출자가 할당한 변수에 대한 포인터입니다. 이 변수의 형식은 필터 드라이버 - 특정입니다. InstanceId에 NULL이 아닌 값이 제공된 경우 NULL이 아닌 값이어야 합니다.

_iid

필터 드라이버에 대한 포인터 - 동일한 필터 드라이버에서 만든 스트림별 컨텍스트 구조를 구분하는 데 사용할 수 있는 할당된 변수입니다. 이 변수의 형식은 필터 드라이버 - 특정입니다.

OwnerId와 InstanceId가 모두 NULL인 경우 FsRtlLookupPerStreamContext는 찾은 첫 번째 스트림당 컨텍스트를 반환합니다.

OwnerId에 NULL이 아닌 값이 제공되고 InstanceId가 NULL인 경우 FsRtlLookupPerStreamContext는 OwnerId 멤버가 OwnerId 매개 변수와 일치하는 스트림당 첫 번째 컨텍스트를 반환합니다.

반환 값

없음

설명

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

참고FsRtlLookupPerStreamContext 는 스트림별 컨텍스트를 지원하는 파일 시스템에서만 사용할 수 있습니다.

스트림별 컨텍스트 구조를 초기화하려면 FsRtlInitPerStreamContext 매크로를 사용합니다.

초기화된 스트림별 컨텍스트 구조를 파일 스트림과 연결하려면 FsRtlInsertPerStreamContext를 호출합니다.

파일 스트림과 연결된 스트림별 컨텍스트 구조를 제거하려면 FsRtlRemovePerStreamContext를 호출합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 SP4 업데이트 롤업; Windows XP
대상 플랫폼	데스크톱
머리글	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL