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