FSCTL_SET_EXTERNAL_BACKING codice di controllo

Articolo
02/02/2024

Il codice di controllo FSCTL_SET_EXTERNAL_BACKING imposta l'origine di backup per un file, ad esempio un file WIM (Windows Image Format) o un file compresso, da un provider di backup esterno. Il contenuto per i file supportati esternamente può essere generato in volumi diversi dal volume in cui risiede il file.

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 file per il quale è impostato il backup. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: ZwFsControlFile solo. Handle del file per il quale è impostato il backup. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: codice di controllo per l'operazione. Usare FSCTL_SET_EXTERNAL_BACKING per questa operazione.
InputBuffer [in]: puntatore al buffer di input, che contiene WOF_EXTERNAL_INFO struttura seguita dai dati del provider. Per i file supportati da WIM, WOF_EXTERNAL_INFO è seguito da una struttura WIM_PROVIDER_EXTERNAL_INFO .
InputBufferLength [in]: Dimensioni dei dati forniti in InputBuffer.
OutputBuffer [out]: Nessuno. Impostata su NULL.
OutputBufferLength [in]: Impostare su 0.

Blocco dello stato

FltFsControlFile o ZwFsControlFile restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, vengono restituiti i valori NTSTATUS appropriati.

Commenti

Quando il provider di backup per l'origine dati aggiunto è il provider WIM, il buffer di input conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura WIM_PROVIDER_EXTERNAL_INFO . InputBufferLength in questo caso sarà sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

I file compressi singolarmente offrono una buona compressione per i dati che non verranno modificati, inclusi i file eseguibili. Se queste vengono aperte per la scrittura del file verranno decompresse in modo trasparente. Per specificare un file compresso singolarmente, il buffer di input conterrà una struttura WOF_EXTERNAL_INFO seguita da una struttura FILE_PROVIDER_EXTERNAL_INFO_V1 . InputBufferLength in questo caso sarà sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). I singoli file compressi sono disponibili a partire da Windows 10.