IWMProfile 接口

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

IWMProfile 接口是配置文件对象的主接口。 配置文件对象用于配置自定义配置文件。 可以使用 IWMProfile 创建、删除或修改流配置对象和互斥对象。 还可以设置和检索有关配置文件的常规信息。 若要访问配置文件对象的所有功能，应使用继承自 IWMProfile 和 IWMProfile2 的 IWMProfile3。

IWMProfile 也可以通过读取器对象进行访问，你可以在其中使用它来获取有关读取器中加载的文件流的信息。 从读取器访问 IWMProfile 时，可以对配置文件进行更改，但不能将任何更改保存到该文件。 使用现有文件的配置文件作为新配置文件的基础通常很方便。 同步读取器支持 IWMProfile 的方式与读取器相同。

通过读取器或同步读取器获取的配置文件信息并非来自 .prx 文件。 读取器使用 ASF 文件中的信息来组合流配置。 因此，某些配置文件信息（如名称和说明）无法通过读取器获取。

可通过多种方式获取指向 IWMProfile 接口的指针。 配置文件管理器具有创建新配置文件和访问现有配置文件的方法。 所有这些方法都设置 IWMProfile 指针。 读取文件时，可以通过调用任何读取器接口的 QueryInterface 方法来获取指向 IWMProfile 的指针。 同样，同步读取器对象的任何接口都可以通过调用 QueryInterfaceIWMProfile3 来获取指针。

成员

IWMProfile 接口继承自 IUnknown 接口。 IWMProfile 还具有以下类型的成员：

• 方法

方法

IWMProfile 接口具有这些方法。

方法	说明
AddMutualExclusion	将互斥对象添加到配置文件。
AddStream	将流添加到配置文件。
CreateNewMutualExclusion	为配置文件创建互斥对象。
CreateNewStream	为配置文件创建流配置对象。
GetDescription	检索配置文件的说明。
GetMutualExclusion	从配置文件中检索互斥对象。
GetMutualExclusionCount	检索配置文件中互斥对象的数目。
GetName	检索配置文件的名称。
GetStream	使用索引号从配置文件中检索流。
GetStreamByNumber	使用流的数量从配置文件中检索流。
GetStreamCount	检索配置文件中的流数。
GetVersion	检索配置文件中 Microsoft Windows 媒体服务的版本号。
ReconfigStream	允许对流配置所做的更改包含在配置文件中。
RemoveMutualExclusion	从配置文件中删除互斥对象。
RemoveStream	从配置文件中删除流。
RemoveStreamByNumber	从配置文件中删除流。
SetDescription	指定配置文件的说明。
SetName	指定配置文件的名称。

有关可以使用此接口的 QueryInterface 方法获取哪些接口的信息，请参阅实现此接口的对象的主题。

另请参阅

接口

IWMProfileManager 接口

配置文件管理器对象

读取器对象

同步读取器对象

使用配置文件