Объекты (пакет SDK для формата Windows Media 11)
[Функция, связанная с этой страницей, пакет SDK для Windows Media 11, является устаревшей функцией. Он был заменен средства чтения источника и записи приемника. средства чтения источников и записи приемника оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код средства чтения исходного кода и записи приемников вместо пакета SDK для Windows Media 11, когда это возможно. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]
Пакет SDK для формата Windows Media использует несколько объектов для чтения, записи, редактирования и индексирования ФАЙЛОВ ASF, а также для создания и редактирования профилей. Каждый объект поддерживает ряд интерфейсов. Некоторые интерфейсы поддерживаются в нескольких объектах. В этих случаях все различия в реализации рассматриваются в справочном разделе интерфейса.
Объекты в пакете SDK для формата Windows Media соответствуют COM. Чтобы упростить разработку, каждый объект имеет связанную функцию или метод создания. Объекты следует создавать с помощью функции или метода создания, а не вручную с помощью функции COM CoCreateInstance.
Некоторые интерфейсы добавляются к их именам, например IWMProfile2 и IWMWriter3. В каждом случае нумерованные версии наследуют все методы предыдущих версий и добавляют новые функции.
На каждой странице объекта этой ссылки интерфейсы, включенные в основной COM-объект, сначала перечислены, а затем интерфейсы обратного вызова, которые должны быть реализованы приложением.
В следующей таблице перечислены объекты, поддерживаемые этим пакетом SDK, с описанием функциональных возможностей каждой функции, используемой для ее создания.
| Объект | Описание | Функция создания |
|---|---|---|
| восстановления резервного копирования | Резервное копирование лицензий, обычно на съемный носитель, а затем восстанавливает эти лицензии на другом компьютере. | WMCreateBackupRestorer |
| регистрации устройств | Управляет базой данных регистрации устройства, которая содержит записи для устройств воспроизведения мультимедиа, доступных через сетевое подключение. | WMCreateDeviceRegistration |
| Transcryptor DRM Transcryptor | Преобразует данные мультимедиа, защищенные DRM, в поток данных, который можно отправлять на устройства, использующие протокол DRM 10 Windows Media для сетевых устройств. | WMCreateDRMTranscryptor |
| индексатора | Создает индекс для файлов ASF, чтобы включить поиск в файлах с видеопотоками. | WMCreateIndexer |
| агента отзыва лицензий | Управляет отзывом лицензии. | WMCreateLicenseRevocationAgent |
| редактор метаданных | Изменяет метаданные в заголовке ФАЙЛА ASF. | WMCreateEditor |
| диспетчера профилей | Предоставляет интерфейсы для создания, загрузки и сохранения профилей. Для записи ФАЙЛА ASF требуется профиль. | WMCreateProfileManager |
| средства чтения | Считывает ФАЙЛЫ ASF. Этот объект использует асинхронную модель вызова для своих операций. | WMCreateReader |
| синхронного чтения | Считывает файлы ASF с помощью синхронных вызовов. | WMCreateSyncReader |
| записи | Записывает ФАЙЛЫ ASF. | WMCreateWriter |
| приемник файла записи | Управляет файлами ASF, написанными объектом записи. | WMCreateWriterFileSink |
| приемник сети записи | Управляет потоковой передачей потоковой передачи сетей ASF-файлов, написанных объектом записи. | WMCreateWriterNetworkSink |
| записи push-приемника | Управляет доставкой потокового содержимого на серверы публикации. | WMCreateWriterPushSink |
В следующей таблице перечислены объекты, зависящие от других объектов. Эти объекты создаются методами существующих объектов.
| Объект | Описание | Метод создания |
|---|---|---|
| совместного использования пропускной способности | Управляет сведениями о совместном использовании пропускной способности в профиле. Для профиля может существовать несколько объектов общего доступа к пропускной способности. Существуют различные методы создания объекта общего доступа к пропускной способности в зависимости от того, хотите ли вы создать объект общего доступа к пропускной способности или получить доступ к существующему объекту. |
IWMProfile3::CreateNewBandwidthSharingOR IWMProfile3::GetBandwidthSharing |
| буфера | Содержит образец носителя и все связанные расширения единиц данных. Используется как для написания, так и для чтения примеров. |
IWMWriter::AllocateSampleOR IWMReaderAllocatorEx::AllocateForOutputEx ИЛИ IWMReaderAllocatorEx::AllocateForStreamEx ИЛИ Создается автоматически объектом чтения или синхронным объектом чтения для примера доставки. |
| свойства входных носителей | Управляет свойствами входных данных. Один объект входных свойств может существовать для каждого входного элемента. | IWMWriter::GetInputProps |
| взаимное исключение | Управляет сведениями о взаимном исключении в профиле. Распространенные варианты использования для взаимного исключения — это содержимое с несколькими скоростями и звуковые дорожки на нескольких языках. Существуют различные методы создания объекта взаимного исключения в зависимости от того, нужно ли создать новый объект взаимного исключения или получить доступ к существующему объекту. |
IWMProfile::CreateNewMutualExclusionOR IWMProfile::GetMutualExclusion |
| свойства выходных носителей | Управляет свойствами выходных данных. Для каждого вывода может существовать один объект свойств носителя выходных данных. Эти объекты можно создать с помощью средства чтения или синхронного средства чтения. |
IWMReader::GetOutputPropsOR IWMSyncReader::GetOutputProps |
| профилей | Содержит данные в профиле во время обработки. Объекты профиля создаются в любой момент, когда необходимо управлять профилем. Существуют различные методы создания объекта профиля в зависимости от того, хотите ли вы создать новый профиль или получить доступ к существующему. |
IWMProfileManager::CreateEmptyProfileOR IWMProfileManager::LoadProfileByData ИЛИ IWMProfileManager::LoadProfileByID ИЛИ IWMProfileManager::LoadSystemProfile |
| конфигурации потока | Управляет свойствами потока в профиле. Объекты конфигурации потоков создаются объектами потока в любое время, когда необходимо получить доступ к сведениям о потоке. Существуют различные методы создания объекта конфигурации потока в зависимости от того, хотите ли вы создать новый поток или доступ и существующий. |
IWMProfile::CreateNewStreamOR IWMProfile::GetStream ИЛИ IWMProfile::GetStreamByNumber |
| приоритета потока | Поддерживает список приоритетов потока для профиля. Потоки будут удалены в порядке увеличения приоритета, если доступная пропускная способность ограничена. В профиле может быть только один объект приоритета потока. | IWMProfile3::CreateNewStreamPrioritization |