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 운영 체제의 Windows Vista 이상 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ntifs.h(FltKernel.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL

참고 항목

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

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