FsRtlLookupPerFileContext 함수(ntifs.h)

FsRtlookupPerFileContext 루틴은 지정된 파일과 연결된 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

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

[in, optional] InstanceId

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

반환 값

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

발언

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

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	보편적
헤더	ntifs.h(FltKernel.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

참고 항목

FSRTL_PER_FILE_CONTEXT

FsRtlGetPerFileContextPointer

FsRtlInsertPerFileContext

FsRtlRemovePerFileContext

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