Condividi tramite

REQUEST_OPLOCK_INPUT_BUFFER struttura (winioctl.h)

  • Articolo

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