FsRtlLookupPerFileContext 함수(ntifs.h)

FsRtlLookupPerFileContext 루틴은 지정된 파일과 연결된 FSRTL_PER_FILE_CONTEXT 개체에 대한 포인터를 반환합니다.

구문

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

매개 변수

[in] PerFileContextPointer

파일 컨텍스트를 추적하기 위해 FSRTL(파일 시스템 런타임 라이브러리) 패키지에서 사용하는 불투명 포인터에 대한 포인터입니다. 파일 개체에서 이 포인터를 검색하려면 FsRtlGetPerFileContextPointer 매크로를 사용합니다.

[in, optional] OwnerId

파일별 컨텍스트 구조의 소유자를 고유하게 식별하는 필터 드라이버 할당 변수에 대한 포인터입니다. 이 변수의 형식은 필터 드라이버에 따라 다릅니다. 이 매개 변수는 선택 사항이지만 InstanceId가 NULL이 아닌 경우 NULL이 아닌 매개 변수여야 합니다.

[in, optional] InstanceId

동일한 필터 드라이버에서 만든 파일별 컨텍스트 구조를 구분하는 데 사용할 수 있는 필터 드라이버 할당 변수에 대한 포인터입니다. 이 변수의 형식은 필터 드라이버에 따라 다릅니다. 이 매개 변수는 선택적 요소입니다.

반환 값

OwnerId 및 InstanceId와 일치하는 첫 번째 FSRTL_PER_FILE_CONTEXT 구조체(지정된 경우)에 대한 포인터이거나, 일치하는 항목이 없거나 파일 시스템에서 파일별 컨텍스트를 지원하지 않는 경우 NULL입니다.

설명

OwnerID 및 InstanceId를 지정하지 않으면 필터 드라이버가 파일과 연결된 첫 번째 컨텍스트를 검색할 수 있습니다.

파일 시스템에서 파일별 컨텍스트 개체를 지원하지 않으면 NULL 이 반환됩니다. FsRtlSupportsPerFileContexts 매크로를 사용하여 파일 시스템에서 파일별 컨텍스트 개체를 지원하는지 여부를 확인합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ntifs.h(FltKernel.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

참고 항목

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

레거시 파일 시스템 필터 드라이버에서 Per-File 컨텍스트 추적