FsRtlGetPerStreamContextPointer 매크로(ntifs.h)

아티클
02/26/2024

FsRtlGetPerStreamContextPointer 매크로는 파일 스트림에 대한 파일 시스템의 스트림 컨텍스트를 반환합니다.

구문

void FsRtlGetPerStreamContextPointer(
   _fo
);

매개 변수

_fo

파일 스트림에 대한 파일 개체에 대한 포인터입니다.

반환 값

없음

설명

파일 시스템 필터 드라이버는 FsRtlGetPerStreamContextPointer 매크로를 사용하여 지정된 파일 개체로 표시되는 파일 스트림에 대한 스트림 컨텍스트 포인터를 가져올 수 있습니다. 스트림 컨텍스트 포인터는 파일 스트림에 대한 파일 시스템의 스트림 컨텍스트에 대한 포인터입니다. 이 포인터는 FsRtlInsertPerStreamContext, FsRtlLookupPerStreamContext 및 FsRtlRemovePerStreamContext에 매개 변수로 전달할 수 있습니다.

스트림 컨텍스트 포인터는 파일 시스템에 대한 파일 스트림을 고유하게 식별하는 FSRTL_ADVANCED_FCB_HEADER 구조를 가리킵니다. 이 구조체는 일반적으로 FCB(파일 제어 블록) 또는 SCB(스트림 제어 블록)와 같은 스트림 컨텍스트 개체에 포함됩니다. 파일 스트림이 열리면 파일 시스템은 FCB 또는 SCB에 대한 포인터를 파일 개체의 FsContext 멤버에 저장합니다.

참고FsRtlGetPerStreamContextPointer 매크로는 고급 FCB 헤더를 지원하는 파일 시스템에서만 사용할 수 있습니다.

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

요구 사항

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