FSCTL_SET_EXTERNAL_BACKING kode kontrol

Artikel
02/02/2024

Kode kontrol FSCTL_SET_EXTERNAL_BACKING mengatur sumber cadangan untuk file, seperti file Format Gambar Windows (WIM) atau file terkompresi, oleh penyedia dukungan eksternal. Konten untuk file yang didukung secara eksternal dapat bersumber pada volume selain pada volume tempat file berada.

Untuk melakukan operasi ini, panggil FltFsControlFile atau ZwFsControlFile dengan parameter berikut.

Parameter

Instance [in]: FltFsControlFile saja. Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.
FileObject [in]: FltFsControlFile saja. Objek penunjuk file dari file yang mendukungnya diatur. Parameter ini diperlukan dan tidak boleh NULL.
FileHandle [in]: ZwFsControlFile saja. Handel file tempat backing diatur. Parameter ini diperlukan dan tidak boleh NULL.
FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_SET_EXTERNAL_BACKING untuk operasi ini.
InputBuffer [in]: Penunjuk ke buffer input, yang berisi struktur WOF_EXTERNAL_INFO diikuti oleh data penyedia. Untuk file yang didukung WIM, WOF_EXTERNAL_INFO diikuti oleh struktur WIM_PROVIDER_EXTERNAL_INFO .
InputBufferLength [in]: Ukuran data yang disediakan di InputBuffer.
OutputBuffer [out]: Tidak ada. Atur ke NULL.
OutputBufferLength [in]: Atur ke 0.

Blok status

FltFsControlFile atau ZwFsControlFile mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, nilai NTSTATUS yang sesuai dikembalikan.

Keterangan

Ketika penyedia dukungan untuk sumber data yang ditambahkan adalah penyedia WIM, buffer input akan berisi struktur WOF_EXTERNAL_INFO diikuti oleh struktur WIM_PROVIDER_EXTERNAL_INFO . InputBufferLength dalam hal ini akan menjadi sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

File terkompresi individual menawarkan pemadatan yang baik untuk data yang tidak akan dimodifikasi, termasuk file yang dapat dieksekusi. Jika ini dibuka untuk menulis file akan didekompresi secara transparan. Untuk menentukan file terkompresi individual, buffer input akan berisi struktur WOF_EXTERNAL_INFO diikuti dengan struktur FILE_PROVIDER_EXTERNAL_INFO_V1 . InputBufferLength dalam hal ini akan menjadi sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). File terkompresi individual tersedia dimulai dengan Windows 10.