FSCTL_ADD_OVERLAY codice di controllo

Articolo
03/14/2023

Il codice di controllo FSCTL_ADD_OVERLAY aggiunge una nuova origine di backup esterna allo spazio dei nomi di un volume. Questa origine di backup può essere un file WIM (Windows Image Format).

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

Parametri

Istanza [in]: Solo FltFsControlFile . Puntatore opaco dell'istanza per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
FileObject: [in]: Solo FltFsControlFile . Oggetto puntatore file del volume a cui viene aggiunta la sovrimpressione. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: ZwFsControlFile solo. Handle del volume a cui viene aggiunta la sovrapposizione. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_ADD_OVERLAY per questa operazione.
InputBuffer [in]: puntatore al buffer di input, che deve contenere una struttura WOF_EXTERNAL_INFO . Se necessario, i dati specifici del provider aggiuntivo vengono inclusi immediatamente dopo WOF_EXTERNAL_INFO.
InputBufferLength [in]: Impostare su sizeof(WOF_EXTERNAL_INFO) più le dimensioni di eventuali dati di input del provider aggiuntivi.
OutputBuffer [out]: puntatore al buffer di output che contiene informazioni risultanti dall'operazione di aggiunta.
OutputBufferLength [out]: Dimensioni del buffer a cui punta outputBuffer.

Blocco dello 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	Significato
STATUS_ACCESS_DENIED	Il richiedente non ha privilegi amministrativi.
STATUS_BUFFER_TOO_SMALL	La lunghezza del buffer di output puntata da OutputBuffer e specificata da OutputBufferLength è troppo piccola.
STATUS_INTERNAL_ERROR	Il volume richiesto non è accessibile.
STATUS_INVALID_DEVICE_REQUEST	Il servizio di backup non è presente o non è avviato.

Commenti

Quando l'origine di backup aggiunta è un file WIM (Windows Imaging Format), il buffer di input conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura WIM_PROVIDER_ADD_OVERLAY_INPUT . InputBufferLength in questo caso sarà sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Al termine della richiesta, i dati puntati da OutputBuffer contengono un singolo valore LARGE_INTEGER che rappresenta il nuovo identificatore dell'origine dati per il file WIM.

Altri provider di backup definiranno strutture di parametri di input specifici e tipi di dati di output.