Функция FsRtlCheckUpperOplock (ntifs.h)

Подпрограмма FsRtlCheckUpperOplock обеспечивает проверку оппортунистической блокировки (oplock) во вторичных или многоуровневых файловых системах при удержании состояния изменения. Вторичные файловые системы, такие как сетевые перенаправления и кластеризация файловых служб, вызов FsRtlCheckUpperOplock, когда оплок, удерживаемый в более низкой файловой системе, изменяется состояние. Изменение состояния может произойти в результате разрыва или обновления. FsRtlCheckUpperOplock разорвать блокировку верхней файловой системы, если это необходимо, чтобы подтвердить новое состояние нижнего оплока. Вызывающий объект также может предоставлять необязательные обратные вызовы для уведомлений о подтверждении останова и состоянии ожидания.

Синтаксис

NTSTATUS FsRtlCheckUpperOplock(
  [in]           POPLOCK                       Oplock,
  [in]           ULONG                         NewLowerOplockState,
  [in, optional] PVOID                         CompletionRoutineContext,
  [in, optional] POPLOCK_WAIT_COMPLETE_ROUTINE CompletionRoutine,
                 POPLOCK_FS_PREPOST_IRP        PrePendRoutine,
  [in]           ULONG                         Flags
);

Параметры

[in] Oplock

Непрозрачный указатель на оплок для файла. Этот указатель должен быть инициализирован предыдущим вызовом FsRtlInitializeOplock.

[in] NewLowerOplockState

Значение, представляющее запрошенный оплок, удерживаемый в более низкой файловой системе вторичной файловой системой. Это битовая комбинация OR следующего вида:

[in, optional] CompletionRoutineContext

Указатель на сведения о контексте, определяемые вызывающим объектом, которые необходимо передать в подпрограммы обратного вызова, на которые указывают параметры CompletionRout ine и PrePendIrpRoutine.

[in, optional] CompletionRoutine

Указатель на подпрограмму обратного вызова, предоставленного вызывающим абонентом. Если выполняется оппортунистическая блокировка, эта подпрограмма вызывается при завершении разрыва. Этот параметр является необязательным и может иметь значение NULL. Если значение NULL, вызывающий объект помещается в состояние ожидания до завершения оппортунистического разрыва блокировки.

Объявление и описание параметров этой подпрограммы приведены следующим образом:

typedef VOID
(*POPLOCK_WAIT_COMPLETE_ROUTINE) (
      _In_ PVOID Context,
      _In_opt_ PIRP Irp
      );

PrePendRoutine

Указатель на подпрограмму обратного вызова, предоставленного вызывающим, если FsRtlCheckUpperOplock вернет STATUS_PENDING. Этот параметр является необязательным и может иметь значение NULL.

Объявление и описание параметров этой подпрограммы приведены следующим образом:

typedef VOID
(*POPLOCK_FS_PREPOST_IRP) (
      _In_ PVOID Context,
      _in_opt_ PIRP Irp
      );

[in] Flags

Битовая маска для связанной операции ввода-вывода файла. Файловая система или драйвер фильтра задает биты, чтобы указать поведение FsRtlCheckUpperOplock. Параметр флагов имеет следующие параметры:

Возвращаемое значение

FsRtlCheckUpperOplock возвращает соответствующий код NTSTATUS, например один из следующих:

Требования

См. также

FsRtlCheckOplockEx

FsRtlUpperOplockFsctrl