iFileSystemImage：：get_StageFiles 方法 (imapi2fs.h)

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

语法

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

[out] pVal

VARIANT_TRUE 是否要求将添加到文件系统映像的文件在刻录前暂存到一个或多个阶段文件中。否则 ，如果 允许 IMAPI 通过不暂存要添加到文件系统映像的文件来优化映像创建过程，则返回VARIANT_FALSE。

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

返回代码	说明
E_POINTER	指针无效。值：0x80004003

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

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

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

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

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