配置文件对象

[与此页面关联的功能(Windows Media Format 11 SDK)是一项旧功能。 它已被 源读取器接收器编写器取代。 源读取器接收器编写器 已针对 Windows 10 和 Windows 11 进行了优化。 Microsoft强烈建议新代码尽可能使用 源读取器接收器编写器,而不是 Windows 媒体格式 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 控制配置文件中的带宽共享和流式处理优先级信息。 继承 IWMProfileIWMProfile2的所有方法。

 

对象

Profile Manager 对象

配置文件