FsRtlInsertPerFileContext 함수(ntifs.h)
FsRtlInsertPerFileContext 루틴은 FSRTL_PER_FILE_CONTEXT 개체를 파일에 대한 드라이버 지정 컨텍스트 개체와 연결합니다.
구문
NTSTATUS FsRtlInsertPerFileContext(
[in] PVOID *PerFileContextPointer,
[in] PFSRTL_PER_FILE_CONTEXT Ptr
);
매개 변수
[in] PerFileContextPointer
파일 컨텍스트를 추적하기 위해 FSRTL(파일 시스템 런타임 라이브러리) 패키지에서 사용하는 불투명 포인터에 대한 포인터입니다. 파일 개체에서 이 포인터를 검색하려면 FsRtlGetPerFileContextPointer 매크로를 사용합니다.
[in] Ptr
드라이버별 컨텍스트 구조에 대한 포인터입니다.
반환 값
FsRtlInsertPerFileContext 루틴은 STATUS_SUCCESS 또는 다음과 같은 적절한 오류 코드를 반환합니다.
반환 코드 | 설명 |
---|---|
|
기본 파일 시스템은 필터 파일 컨텍스트를 지원하지 않습니다. FsRtlSupportsPerFileContexts 매크로를 사용하여 파일 시스템이 파일 컨텍스트 개체별로 지원하는지 여부를 검사 수 있습니다. |
|
시스템에서 리소스(일반적으로 메모리)를 할당할 수 없습니다. |
설명
FsRtlGetPerFileContextPointer 매크로는 열려 있는 파일에 대한 FileContextSupportPointer 를 반환합니다.
매개 변수
FileObject
FILE_OBJECT
파일 개체에 대한 포인터입니다.
반환 값
PVOID
FsRtlGetPerFileContextPointer 매크로는 파일 컨텍스트를 추적하기 위해 FSRTL(파일 시스템 런타임 라이브러리) 패키지에서 사용하는 불투명 포인터를 반환합니다. 파일 시스템에서 파일과 함께 파일별 컨텍스트 개체의 사용을 지원하지 않는 경우 매크로는 NULL 을 반환합니다.
FsRtlGetPerFileContextPointer 매크로는 FsRtlInsertPerFileContext, FsRtllookupPerFileContext 및 FsRtlRemovePerFileContext와 같은 루틴에 전달할 포인터를 반환합니다.
컨텍스트 개체를 사용하고 만드는 방법에 대한 자세한 내용은 레거시 파일 시스템 필터 드라이버에서 Per-File 컨텍스트 추적을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
대상 플랫폼 | 유니버설 |
헤더 | ntifs.h(FltKernel.h, Ntifs.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <=APC_LEVEL |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기