структура OPLOCK_KEY_CONTEXT (ntddk.h)

Статья
02/07/2025

Структура OPLOCK_KEY_CONTEXT возвращается из IoGetOplockKeyContextEx. Эта структура содержит ключи oplock для определенного объекта файла.

Синтаксис

typedef struct _OPLOCK_KEY_CONTEXT {
  USHORT Version;
  USHORT Flags;
  GUID   ParentOplockKey;
  GUID   TargetOplockKey;
  ULONG  Reserved;
} OPLOCK_KEY_CONTEXT, *POPLOCK_KEY_CONTEXT;

Члены

Version

Версия ключа oplock. Версия имеет одно из следующих значений:

Ценность	Значение
OPLOCK_KEY_VERSION_WIN7	Это ключ оплока Windows 7.
OPLOCK_KEY_VERSION_WIN8	Это ключ оплока Windows 8.

Flags

Набор флагов, указывающий тип ключа oplock. Флаги заданы для одного или обоих из следующих значений:

Ценность	Значение
OPLOCK_KEY_FLAG_PARENT_KEY	Допустимый ключ oplock присутствует в ParentOplockKey.
OPLOCK_KEY_FLAG_TARGET_KEY	Допустимый ключ oplock присутствует в TargetOplockKey.

ParentOplockKey

Guid GUID, представляющий значение ключа родительского oplock.

TargetOplockKey

Guid GUID, представляющий значение ключа целевого элемента oplock.

Reserved

Замечания

Если во время запроса IRP_MJ_CREATE запрашивается оплок, файловая система, поддерживающая oplocks, присоединяет контекст ключа oplock к созданному объекту файла. Контекст ключа oplock позже доступен через указатель на структуру OPLOCK_KEY_CONTEXT. Структура OPLOCK_KEY_CONTEXT возвращается из вызова IoGetOplockKeyContextEx.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта структура доступна начиная с Windows 8.
заголовка	ntddk.h (include Ntddk.h)

См. также

IoGetOplockKeyContextEx

семантики Oplock

Поделиться через