FSCTL_ADD_OVERLAY-Steuerelementcode

Artikel
03/14/2023

Der FSCTL_ADD_OVERLAY-Steuerelementcode fügt dem Namespace eines Volumes eine neue externe Sicherungsquelle hinzu. Bei dieser Sicherungsquelle kann es sich um eine WIM-Datei (Windows Image Format) handeln.

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 des Volumes, dem die Überlagerung hinzugefügt wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileHandle [in]: Nur ZwFsControlFile . Das Handle des Volumes, dem die Überlagerung hinzugefügt wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FsControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_ADD_OVERLAY .
InputBuffer [in]: Ein Zeiger auf den Eingabepuffer, der eine WOF_EXTERNAL_INFO-Struktur enthalten muss. Bei Bedarf werden unmittelbar nach WOF_EXTERNAL_INFO zusätzliche anbieterspezifische Daten einbezogen.
InputBufferLength [in]: Legen Sie auf sizeof(WOF_EXTERNAL_INFO) plus die Größe aller zusätzlichen Anbietereingabedaten fest.
OutputBuffer [out]: Ein Zeiger auf den Ausgabepuffer, der alle resultierenden Informationen aus dem Add-Vorgang enthält.
OutputBufferLength [out]: Größe des Puffers, auf den von OutputBuffer verwiesen wird.

Statusblock

FltFsControlFile oder ZwFsControlFile gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die entsprechende Funktion möglicherweise einen der folgenden NTSTATUS-Werte zurück.

Code	Bedeutung
STATUS_ACCESS_DENIED	Der Anforderer verfügt nicht über Administratorrechte.
STATUS_BUFFER_TOO_SMALL	Die Länge des Ausgabepuffers, auf den outputBuffer verweist und von OutputBufferLength angegeben wird, ist zu klein.
STATUS_INTERNAL_ERROR	Auf das angeforderte Volume kann nicht zugegriffen werden.
STATUS_INVALID_DEVICE_REQUEST	Der Unterstützungsdienst ist nicht vorhanden oder nicht gestartet.

Hinweise

Wenn die hinzugefügte Sicherungsquelle eine WIM-Datei (Windows Imaging Format) ist, enthält der Eingabepuffer eine WOF_EXTERNAL_INFO-Struktur gefolgt von einer WIM_PROVIDER_ADD_OVERLAY_INPUT-Struktur . Der InputBufferLength ist in diesem Fall sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_ADD_OVERLAY_INPUT). Nach Abschluss der Anforderung enthalten die Daten, auf die von OutputBuffer verwiesen wird, einen einzelnen LARGE_INTEGER Wert, bei dem es sich um den neuen Datenquellenbezeichner für die WIM-Datei handelt.

Andere Unterstützungsanbieter definieren ihre eigenen spezifischen Eingabeparameterstrukturen und Ausgabedatentypen.