Compartir a través de

estructura REQUEST_OPLOCK_INPUT_BUFFER (winioctl.h)

  • Artículo

Contiene la información necesaria para solicitar un bloqueo oportunista (oplock) o para confirmar una interrupción de un bloqueo oportunista con el código de control de FSCTL_REQUEST_OPLOCK.

Sintaxis

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

Miembros

StructureVersion

Versión de la estructura de REQUEST_OPLOCK_INPUT_BUFFER que se está usando. Establezca este miembro en REQUEST_OPLOCK_CURRENT_VERSION.

StructureLength

Longitud de esta estructura, en bytes. Se debe establecer en sizeof(REQUEST_OPLOCK_INPUT_BUFFER).

RequestedOplockLevel

Combinación válida de los siguientes valores de nivel de interbloqueo.

Valor Significado
OPLOCK_LEVEL_CACHE_READ
 Permite a los clientes almacenar en caché las lecturas. Se puede conceder a varios clientes.
OPLOCK_LEVEL_CACHE_HANDLE
 Permite a los clientes almacenar en caché los identificadores abiertos. Se puede conceder a varios clientes.
OPLOCK_LEVEL_CACHE_WRITE
 Permite a los clientes almacenar en caché las escrituras y los bloqueos de intervalo de bytes. Solo se puede conceder a un solo cliente.
 

Las combinaciones válidas de estos valores son las siguientes:

  • 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 obtener más información sobre estas combinaciones de valores, vea FSCTL_REQUEST_OPLOCK.

Flags

Combinación válida de los siguientes valores de marca de solicitud.

Valor Significado
REQUEST_OPLOCK_INPUT_FLAG_REQUEST
 Solicitar un nuevo interbloqueo. Establecer esta marca junto con REQUEST_OPLOCK_INPUT_FLAG_ACK no es válida y hará que se produzca un error en la solicitud con ERROR_INVALID_PARAMETER.
REQUEST_OPLOCK_INPUT_FLAG_ACK
 Confirmación de una interrupción de interbloqueo. Establecer esta marca junto con REQUEST_OPLOCK_ INPUT_FLAG_REQUEST no es válida y hará que se produzca un error en la solicitud con ERROR_INVALID_PARAMETER.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER