FSCTL_SET_EXTERNAL_BACKING控件程式代碼

發行項
02/02/2024

FSCTL_SET_EXTERNAL_BACKING控件程式代碼會由外部支援提供者設定檔案的備份來源，例如 Windows 映像格式 (WIM) 檔案或壓縮檔。外部支援檔案的內容可能來自檔案所在磁碟區以外的磁碟區。

若要執行這項作業，請使用下列參數呼叫 FltFsControlFile 或 ZwFsControlFile 。

參數

實例 [in]： 僅限 FltFsControlFile 。呼叫端的不透明實例指標。這個參數是必要的，而且不能是 NULL。
FileObject [in]： 僅限 FltFsControlFile 。設定支援之檔案的檔案指針對象。這個參數是必要的，而且不能是 NULL。
FileHandle [in]： 僅限 ZwFsControlFile 。設定支援之檔案的句柄。這個參數是必要的，而且不能是 NULL。
FsControlCode [in]：作業的控制程序代碼。針對此作業使用 FSCTL_SET_EXTERNAL_BACKING 。
InputBuffer [in]：輸入緩衝區的指標，其中包含 WOF_EXTERNAL_INFO 結構，後面接著提供者數據。針對 WIM 支援的檔案， WOF_EXTERNAL_INFO 後面接著 WIM_PROVIDER_EXTERNAL_INFO 結構。
InputBufferLength [in]： InputBuffer 中提供的數據大小。
OutputBuffer [out]： None。設定為 NULL。
OutputBufferLength [in]：設定為 0。

狀態區塊

FltFsControlFile 或 ZwFsControlFile 會在作業成功時傳回STATUS_SUCCESS。否則，會傳回適當的NTSTATUS值。

備註

當新增數據源的支援提供者是WIM提供者時，輸入緩衝區會包含 WOF_EXTERNAL_INFO 結構，後面接著 WIM_PROVIDER_EXTERNAL_INFO 結構。在此情況下， InputBufferLength 會 是 sizeof (WOF_EXTERNAL_INFO) + sizeof (WIM_PROVIDER_EXTERNAL_INFO) 。

個別壓縮的檔案會針對不會修改的數據提供良好的壓縮，包括可執行檔。如果開啟這些檔案以寫入，則會以透明方式解壓縮檔案。若要指定個別壓縮的檔案，輸入緩衝區會包含 WOF_EXTERNAL_INFO 結構，後面接著 FILE_PROVIDER_EXTERNAL_INFO_V1 結構。在此情況下， InputBufferLength 會 是 sizeof (WOF_EXTERNAL_INFO) + sizeof (FILE_PROVIDER_EXTERNAL_INFO_V1) 。從 Windows 10 開始，即可使用個別壓縮檔案。