Freigeben über

IFileSystemImage::p ut_StageFiles-Methode (imapi2fs.h)

  • Artikel

Bestimmt, ob die Dateien, die dem Dateisystemimage hinzugefügt werden, vor dem Brennen bereitgestellt werden sollen.

Syntax

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

Parameter

[in] newVal

Legen Sie auf VARIANT_TRUE fest, um zu erzwingen, dass Dateien, die dem Dateisystemimage hinzugefügt werden, vor dem Brennen in einer oder mehreren Phasendateien bereitgestellt werden. Andernfalls wird auf VARIANT_FALSE festgelegt, wenn das Staging nicht erforderlich ist und eine höhere Leistung gewünscht wird.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_NOTIMPL
 Nicht implementiert.

Wert: 0x80004001

Hinweise

"Staging" ist ein Prozess, bei dem vor beginn des Brennvorgangs ein Image auf der Festplatte erstellt wird, das alle zu brennenden Dateien enthält.

Wenn Diese Eigenschaft auf VARIANT_TRUE festgelegt wird, wirkt sich dies nur auf Dateien aus, die hinzugefügt werden, nachdem die -Eigenschaft festgelegt wurde. Diese Dateien werden immer bereitgestellt. Dateien, die nicht vor einem angegebenen Eigenschaftswert von VARIANT_TRUE bereitgestellt wurden, werden nicht bereitgestellt.

Durch Die Angabe VARIANT_FALSE wird der Prozess zur Erstellung von Dateisystemimages auf zwei Arten optimiert:

  • Für die Imagegenerierung ist weniger Zeit erforderlich.
  • Auf einem lokalen Datenträger wird weniger Speicherplatz von imAPI verbraucht.
Um Pufferunterlaufprobleme beim Brennen zu vermeiden, ist jedoch ein bestimmter Mindestdurchsatz für Lesevorgänge für nicht mehr bereitgestellte Dateien erforderlich. Für den Fall, dass der Dateizugriff oder der Durchsatz möglicherweise nicht die Anforderungen des Brenners erfüllt, erzwingt IMAPI das Datei-Staging unabhängig vom angegebenen Eigenschaftswert. Beispielsweise wird das Datei-Staging für Quelldateien von Wechseldatenträgern wie USB-Flashdatenträgern erzwungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imapi2fs.h

Weitere Informationen

IFileSystemImage

IFileSystemImage::get_StageFiles