estrutura REQUEST_OPLOCK_INPUT_BUFFER (winioctl.h)

  • Artigo

Contém as informações para solicitar um bloqueio oportunista (oplock) ou para reconhecer uma quebra de oplock com o código de controle FSCTL_REQUEST_OPLOCK.

Sintaxe

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

Membros

StructureVersion

A versão da estrutura REQUEST_OPLOCK_INPUT_BUFFER que está sendo usada. Defina esse membro como REQUEST_OPLOCK_CURRENT_VERSION.

StructureLength

O comprimento dessa estrutura, em bytes. Deve ser definido como sizeof(REQUEST_OPLOCK_INPUT_BUFFER).

RequestedOplockLevel

Uma combinação válida dos seguintes valores de nível de oplock.

Valor Significado
OPLOCK_LEVEL_CACHE_READ
 Permite que os clientes armazenem leituras em cache. Pode ser concedido a vários clientes.
OPLOCK_LEVEL_CACHE_HANDLE
 Permite que os clientes armazenem identificadores abertos em cache. Pode ser concedido a vários clientes.
OPLOCK_LEVEL_CACHE_WRITE
 Permite que os clientes armazenem em cache gravações e bloqueios de intervalo de bytes. Pode ser concedido apenas a um único cliente.
 

Combinações válidas desses valores são as seguintes:

  • 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
Para obter mais informações sobre essas combinações de valores, consulte FSCTL_REQUEST_OPLOCK.

Flags

Uma combinação válida dos valores de sinalizador de solicitação a seguir.

Valor Significado
REQUEST_OPLOCK_INPUT_FLAG_REQUEST
 Solicitação de um novo oplock. Definir esse sinalizador junto com REQUEST_OPLOCK_INPUT_FLAG_ACK não é válido e fará com que a solicitação falhe com ERROR_INVALID_PARAMETER.
REQUEST_OPLOCK_INPUT_FLAG_ACK
 Confirmação de uma quebra de oplock. Definir esse sinalizador junto com REQUEST_OPLOCK_ INPUT_FLAG_REQUEST não é válido e fará com que a solicitação falhe com ERROR_INVALID_PARAMETER.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER