Partager via

IFileSystemImage ::p ut_StageFiles, méthode (imapi2fs.h)

  • Article

Détermine si les fichiers ajoutés à l’image du système de fichiers doivent être intermédiaires avant la gravure.

Syntaxe

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

Paramètres

[in] newVal

Définissez sur VARIANT_TRUE pour forcer les fichiers ajoutés à l’image du système de fichiers à être intermédiaires dans un ou plusieurs fichiers intermédiaires avant de les graver. Sinon, définissez sur VARIANT_FALSE si la préproduction n’est pas requise et que des performances plus élevées sont souhaitées.

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour Description
E_NOTIMPL
 Non implémenté.

Valeur : 0x80004001

Remarques

« Préproduction » est un processus dans lequel une image est créée sur le disque dur, contenant tous les fichiers à graver, avant le début de l’opération de gravure.

La définition de cette propriété sur VARIANT_TRUE affecte uniquement les fichiers qui sont ajoutés après la définition de la propriété : ces fichiers seront toujours intermédiaires. Les fichiers qui n’ont pas été intermédiaires avant une valeur de propriété spécifiée de VARIANT_TRUE ne seront pas intermédiaires.

En spécifiant VARIANT_FALSE, le processus de création d’images du système de fichiers est optimisé de deux manières :

  • Moins de temps est nécessaire pour la génération d’images
  • Moins d’espace est consommé sur un disque local par IMAPI
Toutefois, afin d’éviter les problèmes de sous-exécution de la mémoire tampon pendant la gravure, un certain débit minimal est requis pour les opérations de lecture sur les fichiers non intermédiaires. Dans le cas où l’accessibilité ou le débit des fichiers ne répondent pas aux exigences du graveur, IMAPI applique la mise en lots des fichiers, quelle que soit la valeur de propriété spécifiée. Par exemple, la préproduction de fichiers est appliquée pour les fichiers sources provenant de périphériques de stockage amovibles, tels que le disque flash USB.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête imapi2fs.h

Voir aussi

IFileSystemImage

IFileSystemImage ::get_StageFiles