structure REQUEST_OPLOCK_INPUT_BUFFER (winioctl.h)

  • Article

Contient les informations permettant de demander un verrou opportuniste (oplock) ou d’accuser réception d’un blocage d’opération avec le code de contrôle FSCTL_REQUEST_OPLOCK.

Syntaxe

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

Membres

StructureVersion

Version de la structure REQUEST_OPLOCK_INPUT_BUFFER utilisée. Définissez ce membre sur REQUEST_OPLOCK_CURRENT_VERSION.

StructureLength

Longueur de cette structure, en octets. Cette propriété doit être définie sur sizeof(REQUEST_OPLOCK_INPUT_BUFFER).

RequestedOplockLevel

Combinaison valide des valeurs de niveau oplock suivantes.

Valeur Signification
OPLOCK_LEVEL_CACHE_READ
 Permet aux clients de mettre en cache les lectures. Peut être accordé à plusieurs clients.
OPLOCK_LEVEL_CACHE_HANDLE
 Permet aux clients de mettre en cache des handles ouverts. Peut être accordé à plusieurs clients.
OPLOCK_LEVEL_CACHE_WRITE
 Permet aux clients de mettre en cache les écritures et les verrous de plage d’octets. Ne peut être accordé qu’à un seul client.
 

Les combinaisons valides de ces valeurs sont les suivantes :

  • 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
Pour plus d’informations sur ces combinaisons de valeurs, consultez FSCTL_REQUEST_OPLOCK.

Flags

Combinaison valide des valeurs d’indicateur de requête suivantes.

Valeur Signification
REQUEST_OPLOCK_INPUT_FLAG_REQUEST
 Demande d’un nouvel oplock. La définition de cet indicateur avec REQUEST_OPLOCK_INPUT_FLAG_ACK n’est pas valide et entraîne l’échec de la demande avec ERROR_INVALID_PARAMETER.
REQUEST_OPLOCK_INPUT_FLAG_ACK
 Accusé de réception d’un arrêt oplock. La définition de cet indicateur avec REQUEST_OPLOCK_ INPUT_FLAG_REQUEST n’est pas valide et entraîne l’échec de la demande avec ERROR_INVALID_PARAMETER.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER