IFileSystemImage::get_StageFiles method (imapi2fs.h)

Indicates if the files being added to the file system image should be staged before the burn.

Syntax

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

Parameters

[out] pVal

VARIANT_TRUE if the files being added to the file system image are required to be staged in one or more stage files before burning. Otherwise, VARIANT_FALSE is returned if IMAPI is permitted to optimize the image creation process by not staging the files being added to the file system image.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Remarks

"Staging" is a process in which an image is created on the hard-drive, containing all files to be burned, prior to the initiation of the burn operation.

Setting this this property to VARIANT_TRUE via IFileSystemImage::put_StageFiles will only affect files that are added after the property is set: those files will always be staged. Files that were not staged prior to a specified property value of VARIANT_TRUE, will not be staged.

By specifying VARIANT_FALSE, the file system image creation process is optimized in two ways:

• Less time is required for image generation
• Less space is consumed on a local disk by IMAPI

Requirements

See also

IFileSystemImage

IFileSystemImage::put_StageFiles