FSCTL_GET_EXTERNAL_BACKING kode kontrol

Artikel
02/02/2024

Kode kontrol FSCTL_GET_EXTERNAL_BACKING mendapatkan informasi dukungan untuk file dari penyedia dukungan eksternal. Penyedia dukungan mencakup penyedia Windows Image Format (WIM) atau penyedia file terkompresi individual. Konten untuk file yang didukung secara eksternal dapat berada pada volume selain pada volume yang berisi file yang dikueri.

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 informasi cadangannya dikueri. Parameter ini diperlukan dan tidak boleh NULL.
FileHandle [in]: ZwFsControlFile saja. Handel file yang informasi dukungannya dikueri. Parameter ini diperlukan dan tidak boleh NULL.
FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_GET_EXTERNAL_BACKING untuk operasi ini.
InputBuffer [in]: Tidak ada. Atur ke NULL.
InputBufferLength [in]: Atur ke 0.
OutputBuffer [out]: Penunjuk ke buffer output, yang harus memiliki ukuran yang cukup besar untuk menerima struktur WOF_EXTERNAL_INFO diikuti oleh data penyedia. Untuk file yang didukung WIM, WOF_EXTERNAL_INFO diikuti dengan struktur WIM_PROVIDER_EXTERNAL_INFO . Untuk file yang dikompresi secara individual, WOF_EXTERNAL_INFO diikuti oleh struktur FILE_PROVIDER_EXTERNAL_INFO_V1 .
OutputBufferLength [out]: Ukuran, dalam byte, dari buffer yang diacu oleh OutputBuffer.
LengthReturned [out]: Menentukan jumlah byte yang ditulis ke dalam OutputBuffer pada penyelesaian yang berhasil.

Blok status

FltFsControlFile atau ZwFsControlFile mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi yang sesuai mungkin mengembalikan salah satu nilai NTSTATUS berikut.

Kode	Makna
STATUS_OBJECT_NOT_EXTERNALLY_BACKED	File tidak didukung secara eksternal.
STATUS_INVALID_DEVICE_REQUEST	Layanan dukungan tidak ada atau tidak dimulai.

Keterangan

Ketika penyedia dukungan untuk sumber data yang akan diperbarui adalah file WIM, buffer output akan berisi struktur WOF_EXTERNAL_INFO diikuti oleh struktur WIM_PROVIDER_EXTERNAL_INFO . OutputBufferLength harus setidaknya sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO). Ketika penyedia dukungan adalah file yang dikompresi secara individual, buffer output akan berisi struktur WOF_EXTERNAL_INFO diikuti oleh struktur FILE_PROVIDER_EXTERNAL_INFO_V1 .