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 반환하거나 다음과 같은 적절한 오류 코드를 반환합니다.

반환 코드	묘사
STATUS_INVALID_DEVICE_REQUEST	기본 파일 시스템은 필터 파일 컨텍스트를 지원하지 않습니다. FsRtlSupportsPerFileContexts 매크로를 사용하여 파일 시스템이 파일 컨텍스트 개체당 지원하는지 여부를 확인할 수 있습니다.
STATUS_INSUFFICIENT_RESOURCES	시스템에서 리소스(일반적으로 메모리)를 할당할 수 없습니다.

발언

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

참고 항목

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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