共用方式為


FSCTL_SET_EXTERNAL_BACKING控件程式代碼

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

若要執行這項作業,請使用下列參數呼叫 FltFsControlFileZwFsControlFile

參數

  • 實例 [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。

狀態區塊

FltFsControlFileZwFsControlFile 會在作業成功時傳回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 開始,即可使用個別壓縮檔案。

規格需求

需求類型 需求
最低支援的用戶端 Windows 8.1 更新版
標頭 Ntifs.h (包含 Ntifs.hFltkernel.h)

另請參閱

FltFsControlFile

ZwFsControlFile

FSCTL_DELETE_EXTERNAL_BACKING

FSCTL_GET_EXTERNAL_BACKING

WIM_PROVIDER_EXTERNAL_INFO

WOF_EXTERNAL_INFO