Partager via

Méthode IFileSystemImage ::get_StageFiles (imapi2fs.h)

  • Article

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

Syntaxe

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

Paramètres

[out] pVal

VARIANT_TRUE si les fichiers ajoutés à l’image du système de fichiers doivent être intermédiaires dans un ou plusieurs fichiers de phase avant de les graver. Sinon, VARIANT_FALSE est retourné si IMAPI est autorisé à optimiser le processus de création d’image en ne préproduction pas les fichiers ajoutés à l’image du système de fichiers.

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_POINTER
 Le pointeur n’est pas valide.

Valeur : 0x80004003

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 via IFileSystemImage ::p ut_StageFiles n’affecte que les fichiers qui sont ajoutés une fois la propriété définie : 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’image de 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 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 brûleur, IMAPI applique la préproduction de fichier, 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 ::p ut_StageFiles