codice di controllo FSCTL_OFFLOAD_READ

Il codice di controllo FSCTL_OFFLOAD_READ avvia una lettura offload per un blocco di dati in un sistema di archiviazione che supporta le primitive di lettura offload.

Per eseguire questa operazione, chiamare FltFsControlFile o ZwFsControlFile con i parametri seguenti.

Parametri

• Istanza [in]: solo FltFsControlFile . Puntatore a un'istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

• FileObject [in]: solo FltFsControlFile . Oggetto puntatore file che specifica il file da cui leggere. Questo parametro è obbligatorio e non può essere NULL.

• FileHandle [in]: Solo ZwFsControlFile . Handle di file del file da cui leggere. Questo parametro è obbligatorio e non può essere NULL.

• FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_OFFLOAD_READ per questa operazione.

• InputBuffer [in]: puntatore a una struttura FSCTL_OFFLOAD_READ_INPUT che contiene le dimensioni e l'offset di un blocco di dati da leggere.

• InputBufferLength [in]: dimensioni, in byte, del buffer a cui punta InputBuffer. Questo valore è sizeof(FSCTL_OFFLOAD_READ_INPUT).

• OutputBuffer [out]: puntatore a una struttura FSCTL_OFFLOAD_READ_OUTPUT , che riceve i risultati dell'operazione di lettura offload.

• OutputBufferLength [out]: dimensioni, in byte, del buffer a cui punta il parametro OutputBuffer . Questo valore deve essere almeno sizeof(FSCTL_OFFLOAD_READ_OUTPUT).

Blocco di stato

FltFsControlFile o ZwFsControlFile restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, la funzione appropriata potrebbe restituire uno dei valori NTSTATUS seguenti.

Codice	Meaning
STATUS_INVALID_DEVICE_REQUEST	L'handle specificato non è un handle di file valido
STATUS_INVALID_PARAMETER	Un parametro non è valido. Vedere la sezione Osservazioni.
STATUS_VOLUME_DISMOUNTED	Il volume del file system viene smontato.
STATUS_NOT_SUPPORTED	Le operazioni di lettura di offload non sono supportate in questo volume.
STATUS_OFFLOAD_READ_FILE_NOT_SUPPORTED	Il tipo di file richiesto non è supportato. Le operazioni di offload non sono supportate in questi tipi di file: un file transazionato (TxF); File non utente; File compressi; File crittografati; File sparse; File Metatdata NTFS.
STATUS_FILE_DELETED	Il flusso di dati per questo file non è valido.
STATUS_FILE_CLOSED	L'handle di file è chiuso.
STATUS_INVALID_HANDLE	L'handle di file specificato non è valido.
STATUS_FILE_LOCK_CONFLICT	Accesso in lettura insufficiente a causa dello stato di blocco del file corrente.
STATUS_END_OF_FILE	Il membro FileOffset di FSCTL_OFFLOAD_READ_INPUT inizia dopo la fine del file (EOF).
STATUS_DISMOUNTED_VOLUME	Un'offload read non può verificarsi in un volume smontato.
STATUS_INSUFFICIENT_RESOURCES	Sono disponibili risorse insufficienti per completare la richiesta.
STATUS_BUFFER_TOO_SMALL	OutputBufferLength è troppo piccolo per OutputBuffer per ricevere una struttura FSCTL_OFFLOAD_READ_OUTPUT .

Osservazioni:

La lettura offload è disponibile solo per i file normali. Vedere la descrizione per STATUS_OFFLOAD_READ_FILE_NOT_SUPPORTED per un elenco di tipi di file non supportati.

È possibile che le letture inizino oltre la lunghezza dei dati valida (VDL), ma non oltre EOF.

Quando viene restituito STATUS_INVALID_PARAMETER, l'errore potrebbe essere uno dei parametri non validi seguenti:

• Le dimensioni del file sono minori di PAGE_SIZE.
• InputBufferLength<sizeof(FSCTL_OFFLOAD_READ_INPUT).
• Uno o più di questi membri di FSCTL_OFFLOAD_READ_INPUT non sono corretti:
  • FileOffset non è un multiplo delle dimensioni del settore logico del volume.
  • CopyLength non è un multiplo delle dimensioni del settore logico del volume.
  • Le dimensioni non sono le dimensioni della struttura FSCTL_OFFLOAD_READ_INPUT .
  • FileOffset + CopyLength>MAXULONGLONG.

Requisiti

Tipo di requisito	Requisito
Client minimo supportato	Windows 8
Header	Ntifs.h (include Ntifs.h o Fltkernel.h)

Vedere anche

FltFsControlFile

ZwFsControlFile

FSCTL_OFFLOAD_READ_INPUT

FSCTL_OFFLOAD_READ_OUTPUT