通过

IFsiFileItem2：:p ut_IsRealTime 方法 (imapi2fs.h)

  • 项目

设置文件系统中文件的“实时”属性。 此属性指定内容在写入或读取（例如音频和视频数据）时是否需要最小数据传输速率。

语法

HRESULT put_IsRealTime(
  [in] VARIANT_BOOL newVal
);

参数

[in] newVal

指定 VARIANT_TRUE 以在文件系统映像中设置文件的 Real-Time 属性;否则， VARIANT_FALSE。 默认值为 VARIANT_FALSE。

返回值

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

返回代码/值 说明
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
值：0x00AAB15FL
 当前文件系统修订版不支持此功能，因此，该文件已标记为 Real-Time 但不会在生成的文件系统映像中如此显示，除非在文件系统对象中启用了 UDF 修订版 2.01 或更高版本。
IMAPI_E_PROPERTY_NOT_ACCESSIBLE
值：0xC0AAB160L
 属性 '%1！ls！' 不可访问。
IMAPI_E_INVALID_PARAM
值：0xC0AAB101
 为参数 '%1！ls！' 指定的值 之间的时间间隔无效。
 
注意 目前，使用此方法设置由于 CreateResultImage 操作成功而“只读”的文件的 Real-Time 属性值时，将返回S_OK。
 

注解

将文件添加到文件系统映像时， IFsiDirectoryItem：：AddTree 和 IFsiDirectoryItem2：：AddTreeWithNamedStreams 方法不会设置 Real-Time 属性。 若要将文件标记为实时文件，必须在将文件添加到文件系统映像后枚举这些文件，并单独设置 Real-Time 属性。

如果为表示命名流的文件项调用此方法，则此方法返回错误代码 IMAPI_E_PROPERTY_NOT_ACCESSIBLE ，因为命名流没有 Real-Time 属性。

Windows Server 2003 支持此方法，Service Pack 1 (SP1) 、Windows XP with Service Pack 2 (SP2) ，以及 Windows Vista 通过用于存储的 Windows 功能包。 Windows 7 和 Windows Server 2008 R2 原生支持此更新包提供的所有功能。

要求

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

另请参阅

IFsiFileItem2