FltOplockFsctrl 함수(fltkernel.h)

아티클
08/07/2023

FltOplockFsctrl 은 미니필터 드라이버를 대신하여 다양한 oplock(기회 잠금) 작업을 수행합니다.

구문

FLT_PREOP_CALLBACK_STATUS FLTAPI FltOplockFsctrl(
  [in] POPLOCK            Oplock,
  [in] PFLT_CALLBACK_DATA CallbackData,
  [in] ULONG              OpenCount
);

매개 변수

[in] Oplock

파일에 대한 불투명 불투명 포인터입니다. 이 포인터는 FltInitializeOplock에 대한 이전 호출에 의해 초기화되어야 합니다.

[in] CallbackData

I/O 작업의 FLT_CALLBACK_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

[in] OpenCount

전용 oplock이 요청되는 경우 파일에 대한 사용자 핸들 수입니다. 수준 2, R 또는 RH oplock 요청에 대해 0이 아닌 값을 설정하면 파일에 바이트 범위 잠금이 있음을 나타냅니다. oplock 형식에 대한 자세한 내용은 Oplock 개요를 참조하세요.

반환 값

FltOplockFsctrl은 일부 FSCTL 작업에 대한 FLT_PREOP_PENDING 반환합니다. 자세한 내용은 다음 설명 섹션에 나열된 FSCTL 코드에 대한 참조 페이지를 참조하세요. 그렇지 않으면 FltOplockFsctrl 은 FLT_PREOP_COMPLETE 반환합니다.

설명

미니필터 드라이버는 FltOplockFsctrl 을 호출하여 만들기 또는 파일 시스템 컨트롤 I/O 작업에 대한 다양한 기회 잠금 작업을 수행합니다.

CallbackData 매개 변수가 가리키는 FLT_CALLBACK_DATA 구조체는 IRP 기반 IRP_MJ_FILE_SYSTEM_CONTROL 또는 IRP_MJ_CREATE 작업을 나타내야 합니다.

작업이 IRP_MJ_FILE_SYSTEM_CONTROL 작업인 경우 FltOplockFsctrl 을 다음 FSCTL 코드와 함께 사용할 수 있습니다.

FSCTL 코드는 작업에 대한 FLT_PARAMETERS 구조체의 FsControlCode 멤버에 설정됩니다. FsControlCode 및 기타 IRP_MJ_FILE_SYSTEM_CONTROL 매개 변수에 대한 자세한 내용은 IRP_MJ_FILE_SYSTEM_CONTROL 대한 FLT_PARAMETERS 참조하세요.

기회 잠금에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

작업이 IRP_MJ_CREATE 요청인 경우 다음 조건이 모두 충족되는 경우 FltOplockFsctrl 을 사용하여 보류 중인 필터 기회 잠금을 요청할 수 있습니다.

OpenCount 매개 변수의 값은 1이어야 합니다.
IRP_MJ_CREATE 요청에 대한 DesiredAccess 매개 변수 값은 FILE_READ_ATTRIBUTES. 이 매개 변수는 작업에 대한 FLT_PARAMETERS 구조체의 SecurityContext 멤버에서 설정됩니다. 자세한 내용은 IRP_MJ_CREATE 대한 FLT_PARAMETERS 참조하세요.
IRP_MJ_CREATE 작업에 대한 ShareAccess 매개 변수의 값은 FILE_SHARE_READ, FILE_SHARE_WRITE 또는 FILE_SHARE_DELETE. 이 매개 변수는 작업에 대한 FLT_PARAMETERS 구조체의 ShareAccess 멤버에서 설정됩니다. 자세한 내용은 IRP_MJ_CREATE 대한 FLT_PARAMETERS 참조하세요.

이 함수를 호출하는 필터 및 파일 시스템은 호출을 시스템에서 제공하는 oplock 패키지로 동기화해야 합니다. 자세한 내용은 Oplock 동기화 를 참조하세요.