структура REQUEST_OPLOCK_INPUT_BUFFER (winioctl.h)

  • Статья

Содержит сведения для запроса оппортунистической блокировки (oplock) или подтверждения разрыва блокировки с помощью кода элемента управления FSCTL_REQUEST_OPLOCK .

Синтаксис

typedef struct _REQUEST_OPLOCK_INPUT_BUFFER {
  WORD  StructureVersion;
  WORD  StructureLength;
  DWORD RequestedOplockLevel;
  DWORD Flags;
} REQUEST_OPLOCK_INPUT_BUFFER, *PREQUEST_OPLOCK_INPUT_BUFFER;

Члены

StructureVersion

Версия используемой структуры REQUEST_OPLOCK_INPUT_BUFFER . Задайте для этого элемента значение REQUEST_OPLOCK_CURRENT_VERSION.

StructureLength

Длина этой структуры в байтах. Нужно задать значение sizeof(REQUEST_OPLOCK_INPUT_BUFFER).

RequestedOplockLevel

Допустимое сочетание следующих значений уровня oplock.

Значение Значение
OPLOCK_LEVEL_CACHE_READ
 Позволяет клиентам кэшировать операции чтения. Может быть предоставлено нескольким клиентам.
OPLOCK_LEVEL_CACHE_HANDLE
 Позволяет клиентам кэшировать открытые дескрипторы. Может быть предоставлено нескольким клиентам.
OPLOCK_LEVEL_CACHE_WRITE
 Позволяет клиентам кэшировать записи и блокировки диапазона байтов. Может предоставляться только одному клиенту.
 

Допустимые сочетания этих значений:

  • OPLOCK_LEVEL_CACHE_READ
  • OPLOCK_LEVEL_CACHE_READ | OPLOCK_LEVEL_CACHE_HANDLE
  • OPLOCK_LEVEL_CACHE_READ | OPLOCK_LEVEL_CACHE_WRITE
  • OPLOCK_LEVEL_CACHE_READ | OPLOCK_LEVEL_CACHE_WRITE | OPLOCK_LEVEL_CACHE_HANDLE
Дополнительные сведения об этих сочетаниях значений см. в разделе FSCTL_REQUEST_OPLOCK.

Flags

Допустимое сочетание следующих значений флагов запроса.

Значение Значение
REQUEST_OPLOCK_INPUT_FLAG_REQUEST
 Запрос на новую блокировку. Задание этого флага вместе с REQUEST_OPLOCK_INPUT_FLAG_ACK недопустимо и приведет к сбою запроса с ERROR_INVALID_PARAMETER.
REQUEST_OPLOCK_INPUT_FLAG_ACK
 Подтверждение прерывания операции. Задание этого флага вместе с REQUEST_OPLOCK_ INPUT_FLAG_REQUEST недопустимо и приведет к сбою запроса с ERROR_INVALID_PARAMETER.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER