Интерфейс IWMProfile
[Функция, связанная с этой страницей, Windows Media Format 11 SDK, является устаревшей функцией. Он был заменен средством чтения исходного кода и модуля записи приемника. Средство чтения исходного кода и модуль записи приемника оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код по возможности использовал средство чтения исходного кода и модуль записи приемника вместо пакета SDK для Windows Media Format 11. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Интерфейс IWMProfile является основным интерфейсом для объекта профиля . Объект профиля используется для настройки пользовательских профилей. IWMProfile можно использовать для создания, удаления или изменения объектов конфигурации потока и объектов взаимного исключения. Вы также можете задать и получить общие сведения о профиле. Для доступа ко всем функциям объекта профиля следует использовать IWMProfile3, который наследуется от IWMProfile и IWMProfile2.
IWMProfile также доступен через объект средства чтения, где его можно использовать для получения сведений о потоках файла, загруженного в средство чтения. При доступе к IWMProfile из средства чтения можно внести изменения в профиль, но ни один из изменений не может быть сохранен в файле. Часто бывает удобно использовать профиль существующего файла в качестве основы нового профиля. Синхронное средство чтения поддерживает IWMProfile так же, как и средство чтения.
Сведения о профиле, полученные с помощью средства чтения или синхронного средства чтения, не поступают из PRX-файла. Средство чтения использует сведения в ASF-файле для сборки конфигураций потока. Таким образом, некоторые сведения о профиле, такие как имя и описание, недоступны через средство чтения.
Существует несколько способов получения указателя на интерфейс IWMProfile . Диспетчер профилей имеет методы для создания нового профиля и доступа к существующим профилям. Все эти методы задают указатель IWMProfile . При чтении файла указатель на IWMProfile можно получить, вызвав метод QueryInterface любого интерфейса чтения. Аналогичным образом любой интерфейс синхронного объекта чтения может получить указатель с помощью вызова QueryInterfaceIWMProfile3.
Элементы
Интерфейс IWMProfile наследуется от интерфейса IUnknown . IWMProfile также имеет следующие типы членов:
Методы
Интерфейс IWMProfile содержит следующие методы.
| Метод | Описание |
|---|---|
| AddMutualExclusion | Добавляет объект взаимного исключения в профиль. |
| AddStream | Добавляет поток в профиль. |
| CreateNewMutualExclusion | Создает объект взаимного исключения для профиля. |
| CreateNewStream | Создает объект конфигурации потока для профиля. |
| GetDescription | Получает описание профиля. |
| GetMutualExclusion | Извлекает объект взаимного исключения из профиля. |
| GetMutualExclusionCount | Извлекает количество объектов взаимного исключения в профиле. |
| GetName | Извлекает имя профиля. |
| Getstream | Извлекает поток, используя номер индекса, из профиля. |
| GetStreamByNumber | Извлекает поток, используя номер потока, из профиля. |
| GetStreamCount | Извлекает количество потоков в профиле. |
| GetVersion | Извлекает номер версии служб Microsoft Windows Media в профиле. |
| Перенастройка потока | Включает изменения, внесенные в конфигурацию потока, для включения в профиль. |
| RemoveMutualExclusion | Удаляет объект взаимного исключения из профиля. |
| RemoveStream | Удаляет поток из профиля. |
| RemoveStreamByNumber | Удаляет поток из профиля. |
| SetDescription | Указывает описание профиля. |
| SetName | Задает имя профиля. |
Сведения об интерфейсах, которые можно получить с помощью метода QueryInterface этого интерфейса, см. в разделе об объекте, в котором реализуется этот интерфейс.