Share via

FSCTL_REQUEST_BATCH_OPLOCK IOCTL (winioctl.h)

  • Articolo

Richiede un blocco opportunistico batch su un file.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl usando gli argomenti seguenti.

BOOL b = DeviceIoControl(
  (HANDLE) hDevice,              // handle to file
  FSCTL_REQUEST_BATCH_OPLOCK,    // dwIoControlCode
  NULL,                          // lpInBuffer
  0,                             // nInBufferSize
  NULL,                          // lpOutBuffer
  0,                             // nOutBufferSize
  (LPDWORD) lpBytesReturned,     // number of bytes returned
  (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

Commenti

Questa operazione viene usata solo dalle applicazioni client che richiedono un blocco opportunistico (oplock) da un server locale. Le applicazioni client che richiedono blocchi opportunistici da server remoti non devono richiederle direttamente, ovvero il redirector di rete richiede in modo trasparente blocchi opportunistici per l'applicazione. Un tentativo di usare questa operazione per richiedere blocchi opportunistici dai server remoti comporterà la negazione della richiesta.

Se si desidera un nuovo tipo di oplock, l'handle deve essere chiuso e un nuovo handle riaperto tramite CreateFile e DeviceIoControl deve essere chiamato sul nuovo handle con il codice di controllo FSCTL_REQUEST_OPLOCK desiderato_XXX . Per richiedere un oplock su un handle in cui è possibile modificare il tipo di oplock (l'handle non deve essere chiuso e riaperto), usare il codice di controllo FSCTL_REQUEST_OPLOCK .

Usare FSCTL_REQUEST_BATCH_OPLOCK per richiedere un blocco opportunistico batch su un file. Un file system client può memorizzare nella cache i dati di lettura, scrivere dati e gestire i dati in locale, purché il blocco di livello 1 venga mantenuto.

Il proprietario del blocco operativo batch deve confermare un'interruzione di oplock (vedere Interruzione dei blocchi opportunistici) prima che qualsiasi operazione incompatibile con un oplock batch possa scorrere su un altro handle. Dopo l'interruzione del blocco, il redirector di rete riceve una notifica per non considerare validi i dati memorizzati nella cache dal file.

Per altre informazioni, vedere Tipi di blocchi opportunistici.

Per un confronto dei vari codici di controllo oplock, vedere FSCTL_REQUEST_OPLOCK.

Un codice di controllo FSCTL_REQUEST_BATCH_OPLOCK ha esito negativo se il file viene aperto in modalità non sovrapposta (sincrona).

Per le implicazioni dell'I/O sovrapposto in questa operazione, vedere la sezione Osservazioni dell'argomento DeviceIoControl .

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 No
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) No
File system del volume condiviso cluster (CsvFS) Sì
Resilient File System (ReFS) Sì

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche