REQUEST_OPLOCK_INPUT_BUFFER struttura (winioctl.h)

Articolo
03/13/2024

Contiene le informazioni per richiedere un blocco opportunistico (oplock) o per riconoscere un'interruzione di oplock con il codice di controllo FSCTL_REQUEST_OPLOCK .

Sintassi

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

Members

StructureVersion

Versione della struttura REQUEST_OPLOCK_INPUT_BUFFER usata. Impostare questo membro su REQUEST_OPLOCK_CURRENT_VERSION.

StructureLength

Lunghezza di questa struttura, in byte. Il valore deve essere impostato su sizeof(REQUEST_OPLOCK_INPUT_BUFFER).

RequestedOplockLevel

Combinazione valida dei valori di livello di oplock seguenti.

Valore	Significato
OPLOCK_LEVEL_CACHE_READ	Consente ai client di memorizzare nella cache le letture. Può essere concesso a più client.
OPLOCK_LEVEL_CACHE_HANDLE	Consente ai client di memorizzare nella cache handle aperti. Può essere concesso a più client.
OPLOCK_LEVEL_CACHE_WRITE	Consente ai client di memorizzare nella cache le scritture e i blocchi dell'intervallo di byte. Può essere concesso solo a un singolo client.

Le combinazioni valide di questi valori sono le seguenti:

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

Per altre informazioni su queste combinazioni di valori, vedere FSCTL_REQUEST_OPLOCK.

Flags

Combinazione valida dei valori di flag di richiesta seguenti.

Valore	Significato
REQUEST_OPLOCK_INPUT_FLAG_REQUEST	Richiedere un nuovo oplock. L'impostazione di questo flag insieme a REQUEST_OPLOCK_INPUT_FLAG_ACK non è valida e causerà l'esito negativo della richiesta con ERROR_INVALID_PARAMETER.
REQUEST_OPLOCK_INPUT_FLAG_ACK	Riconoscimento di un'interruzione di oplock. L'impostazione di questo flag insieme a REQUEST_OPLOCK_ INPUT_FLAG_REQUEST non è valida e causerà l'esito negativo della richiesta con ERROR_INVALID_PARAMETER.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

FSCTL_REQUEST_OPLOCK

REQUEST_OPLOCK_OUTPUT_BUFFER

Condividi tramite