FSCTL_SET_EXTERNAL_BACKING Steuerungscode

Artikel
02/12/2024

Der FSCTL_SET_EXTERNAL_BACKING-Steuerelementcode legt die Sicherungsquelle für eine Datei fest, z. B. eine WIM-Datei (Windows Image Format) oder eine komprimierte Datei, von einem externen Sicherungsanbieter. Inhalte für extern gesicherte Dateien können auf anderen Volumes als auf dem Volume bezogen werden, auf dem sich die Datei befindet.

Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.

Parameter

Instanz [in]: Nur FltFsControlFile . Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileObject [in]: Nur FltFsControlFile . Das Dateizeigerobjekt der Datei, für die die Unterstützung festgelegt ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: nur ZwFsControlFile . Das Handle der Datei, für die die Unterstützung festgelegt ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_SET_EXTERNAL_BACKING .
InputBuffer [in]: Ein Zeiger auf den Eingabepuffer, der WOF_EXTERNAL_INFO Struktur gefolgt von den Anbieterdaten enthält. Bei von WIM gesicherten Dateien folgt WOF_EXTERNAL_INFO eine WIM_PROVIDER_EXTERNAL_INFO-Struktur .
InputBufferLength [in]: Größe der im InputBuffer bereitgestellten Daten.
OutputBuffer [out]: Keine. Auf NULL festgelegt.
OutputBufferLength [in]: Auf 0 festgelegt.

Statusblock

FltFsControlFile oder ZwFsControlFile gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls werden die entsprechenden NTSTATUS-Werte zurückgegeben.

Hinweise

Wenn der Sicherungsanbieter für die hinzugefügte Datenquelle der WIM-Anbieter ist, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer WIM_PROVIDER_EXTERNAL_INFO-Struktur . Die InputBufferLength lautet in diesem Fall sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO).

Einzeln komprimierte Dateien bieten eine gute Komprimierung für Daten, die nicht geändert werden, einschließlich ausführbarer Dateien. Wenn diese zum Schreiben geöffnet werden, wird die Datei transparent dekomprimiert. Um eine einzeln komprimierte Datei anzugeben, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer FILE_PROVIDER_EXTERNAL_INFO_V1-Struktur . Die InputBufferLength ist in diesem Fall sizeof(WOF_EXTERNAL_INFO) + sizeof(FILE_PROVIDER_EXTERNAL_INFO_V1). Einzelne komprimierte Dateien sind ab Windows 10 verfügbar.