Profile 对象

[与此页面关联的功能 Windows Media Format 11 SDK 是旧版功能。 它已被源读取器和接收器编写器取代。 源读取器和接收器编写器已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用源读取器和接收器编写器,而不是 Windows Media Format 11 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

配置文件对象管理配置文件的设置。 可以为现有配置文件数据创建配置文件对象,也可以创建空对象,准备接收新数据。 加载文件时, (读取器对象和同步读取器对象) 创建配置文件对象。 在这种情况下,对象将使用存储在文件标头中的配置文件信息填充。

若要保存配置文件对象的内容,必须调用 IWMProfileManager::SaveProfile

配置文件包含多个对象,这些对象控制配置文件 (的各个方面,例如流) 。 所有这些对象都从属于配置文件对象。 使用创建函数创建这些对象时,不会像使用此 SDK 的主要对象那样创建这些对象。 相反,配置文件对象的接口包含创建从属对象的方法。

若要创建配置文件对象,请调用以下方法之一。

方法 描述
IWMProfileManager::CreateEmptyProfile 创建没有任何配置文件数据的配置文件对象。
IWMProfileManager::LoadProfileByData 创建使用保存为字符串的配置文件中的数据填充的配置文件对象。 这是使用自定义配置文件中的数据创建配置文件对象的唯一方法。
IWMProfileManager::LoadProfileByID 创建使用系统配置文件中的数据填充的配置文件对象。 使用 GUID 标识所需的系统配置文件。
IWMProfileManager::LoadSystemProfile 创建使用系统配置文件中的数据填充的配置文件对象。 使用配置文件索引来标识所需的系统配置文件。

 

上表中的所有方法都设置了指向 IWMProfile 接口的指针。 可以通过调用 QueryInterface 方法获取配置文件对象的其他接口。

每个配置文件对象都支持以下接口。

接口 描述
IWMLanguageList 管理 ASF 文件支持的语言列表。
IWMPacketSize 控制文件中数据包的最大大小。
IWMPacketSize2 控制文件中数据包的最小大小。 继承 IWMPacketSize 的所有方法。
IWMProfile 控制配置文件中包含的基本设置和对象。
IWMProfile2 检索与配置文件关联的全局唯一标识符 (GUID) 。 继承 IWMProfile 的所有方法。
IWMProfile3 控制配置文件中的带宽共享和流式处理优先级信息。 继承 IWMProfile 和 IWMProfile2 的所有方法。

 

对象

配置文件管理器对象

配置文件