FsRtlLookupPerFileObjectContext 함수(ntifs.h)

  • 아티클

"레거시" 파일 시스템 필터 드라이버의 경우 FsRtlLookupPerFileObjectContext 함수는 이전에 파일 개체와 연결된 컨텍스트 정보를 검색합니다.

구문

PFSRTL_PER_FILEOBJECT_CONTEXT FsRtlLookupPerFileObjectContext(
  [in]           PFILE_OBJECT FileObject,
  [in, optional] PVOID        OwnerId,
  [in, optional] PVOID        InstanceId
);

매개 변수

[in] FileObject

컨텍스트 정보를 쿼리할 파일 개체에 대한 포인터입니다.

[in, optional] OwnerId

파일별 개체 컨텍스트 구조의 소유 필터를 고유하게 식별하는 호출자 할당 변수에 대한 포인터입니다. 이 변수의 형식은 필터 드라이버에 따라 다릅니다.

[in, optional] InstanceId

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

반환 값

FsRtlLookupPerFileObjectContext 는 발견된 파일별 개체별 첫 번째 일치 컨텍스트에 대한 포인터를 반환합니다. 일치하는 항목이 없으면 FsRtlLookupPerFileObjectContext 는 NULL을 반환합니다.

설명

"레거시" 파일 시스템 필터 드라이버는 FsRtlLookupPerFileObjectContext 를 호출하여 파일 개체에 대한 파일별 개체 컨텍스트 구조를 검색합니다. 컨텍스트 구조에는 필터 드라이버가 파일 개체에 대해 유지 관리하는 컨텍스트 정보가 포함됩니다. 이 컨텍스트 구조는 이전에 FsRtlInsertPerFileObjectContext 함수를 호출하여 파일 개체와 연결되어야 합니다.

FSRTL_PER_FILEOBJECT_CONTEXT 구조체가 파일 개체별 정의 컨텍스트 구조에 정의된 필터에 포함된 경우 CONTAINING_RECORD 매크로를 사용하여 필터 정의 구조체의 헤드에 대한 포인터를 가져올 수 있습니다.

파일별 개체 컨텍스트 구조를 초기화하려면 FsRtlInitPerFileObjectContext 매크로를 사용합니다.

초기화된 파일 개체별 컨텍스트 구조를 파일 개체와 연결하려면 FsRtlInsertPerFileObjectContext 함수를 사용합니다.

파일 개체와 연결된 파일별 개체 컨텍스트 구조를 제거하려면 FsRtlRemovePerFileObjectContext 함수를 사용합니다.

참고 파일 시스템 미니필터 드라이버는 FsRtlXxxPerFileObjectContext 함수를 사용하면 안 됩니다. 대신, 미니 필터는 FltXxx컨텍스트 함수를 사용하여 컨텍스트 정보를 파일 개체와 연결할 수 있습니다. 전체 목록은 FSRTL_PER_FILEOBJECT_CONTEXT 항목을 참조하세요.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
대상 플랫폼 유니버설
헤더 ntifs.h(Fltkernel.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

추가 정보

FSRTL_PER_FILEOBJECT_CONTEXT

FsRtlInitPerFileObjectContext

FsRtlInsertPerFileObjectContext

FsRtlRemovePerFileObjectContext