IFileSystemImage：:p ut_StageFiles 方法 (imapi2fs.h)

确定是否应在刻录之前暂存要添加到文件系统映像的文件。

语法

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

[in] newVal

设置为 VARIANT_TRUE 以强制添加到文件系统映像的文件在刻录前暂存到一个或多个阶段文件中。否则，如果不需要暂存且需要更高的性能，则设置为 VARIANT_FALSE。

成功后返回S_OK，但实现后可能会返回其他成功代码。以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：

返回代码	说明
E_NOTIMPL	未实现。值：0x80004001

“暂存”是在启动刻录操作之前在硬盘驱动器上创建映像的过程，其中包含要刻录的所有文件。

将此属性设置为 VARIANT_TRUE 将仅影响设置属性后添加的文件：这些文件将始终暂存。在指定的属性值 VARIANT_TRUE 之前未暂存的文件将不会暂存。

通过指定 VARIANT_FALSE，文件系统映像创建过程可通过两种方式进行优化：

但是，为了避免在燃烧过程中出现缓冲区不足问题，对非暂存文件执行读取操作需要特定的最小吞吐量。如果文件可访问性或吞吐量不满足燃烧器的要求，IMAPI 将强制实施文件暂存，而不考虑指定的属性值。例如，对来自可移动存储设备（如 USB 闪存盘）的源文件强制实施文件暂存。

要求	值
最低受支持的客户端	Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi2fs.h