Интерфейсы для приложений

В этом разделе описываются интерфейсы, используемые или реализованные приложениями, использующими пакет SDK для диспетчер устройств Windows Media для взаимодействия с устройствами. Термин "приложение", используемый здесь, означает любой исполняемый файл, подключаемый модуль или COM-объект, который существует на настольном компьютере и нуждается в высокоуровневом взаимодействии с подключенным портативным устройством. Это может быть приложение проигрывателя мультимедиа, подключаемый модуль Медиаплеер Windows (если ему нужен прямой доступ к переносимому устройству) или COM-объект счетчика воспроизведения.

Некоторые из этих интерфейсов реализуются приложением, а другие вызываются приложением. В документации по каждому интерфейсу указывается, реализуется ли он или вызывается (и если реализовано, является ли он необязательным или обязательным).

Приложения используют следующие интерфейсы или классы.

Интерфейс или класс	Описание
Класс CSecureChannelClient	Вспомогательный класс, который позволяет приложениям выполнять проверку подлинности, шифровать и расшифровывать данные, а также создавать mac.
IWMDeviceManager	Интерфейс верхнего уровня Windows Media диспетчер устройств для приложений.
IWMDeviceManager2	Расширяет IWMDeviceManager , предоставляя расширенные методы перечисления и другие методы.
IWMDeviceManager3	Расширяет интерфейс IWMDeviceManager2 , предоставляя метод, который задает предпочтение перечисления устройств.
IWMDMDevice	Предоставляет методы для проверки и изучения одного переносимого устройства.
IWMDMDevice2	Расширяет IWMDMDevice , позволяя получить форматы видео, поддерживаемые устройством, найти хранилище по имени и использовать страницы свойств.
IWMDMDevice3	Расширяет IWMDMDevice2 , предоставляя методы для запроса свойств устройства, отправки кодов управления вводом-выводом устройства, а также предоставления обновленных методов для поиска хранилищ и получения возможностей формата устройства.
IWMDMDeviceControl	Предоставляет методы для управления устройствами.
IWMDMDeviceSession	Повышение эффективности операций устройства путем объединения нескольких операций в один сеанс
IWMDMEnumDevice	Перечисляет переносные устройства, подключенные к компьютеру.
IWMDMEnumStorage	Перечисляет хранилища на устройстве.
IWMDMMetaData	Задает и извлекает свойства метаданных (например, исполнитель, альбом, жанр и т. д.) хранилища.
IWMDMObjectInfo	Возвращает и задает сведения, управляющие обработкой воспроизводимых файлов на устройстве с помощью интерфейса IWMDMDeviceControl .
IWMDMRevoked	Извлекает URL-адрес, с которого можно скачать обновленные компоненты, если передача завершается ошибкой отзыва.
IWMDMStorage	Предоставляет методы для проверки и изучения хранилища (файла, папки, списка воспроизведения) на устройстве.
IWMDMStorage2	Расширяет IWMDMStorage , позволяя получить дочернее хранилище по имени, а также получить и задать расширенные атрибуты.
IWMDMStorage3	Расширяет IWMDMStorage2 , предоставляя метаданные.
IWMDMStorage4	Расширяет IWMDMStorage3 , предоставляя методы для получения подмножества доступных метаданных для хранилища, а также для задания и получения списка ссылок на другие хранилища.
IWMDMStorageControl	Используется для вставки, удаления или перемещения файлов на устройстве или между устройством и компьютером.
IWMDMStorageControl2	Расширяет IWMDMStorageControl , позволяя задать имя целевого файла при вставке содержимого в хранилище.
IWMDMStorageControl3	Расширяет IWMDMStorageControl2 , позволяя передавать указатель интерфейса IWMDMMetaData .
IWMDMStorageGlobals	Предоставляет методы для получения глобальных сведений о носителе (например, флэш-диске карта) на устройстве.
IWMDRMDeviceApp	Позволяет приложению выполнять измерение, синхронизацию лицензий и обновление компонентов DRM устройства.
IWMDRMDeviceApp2	Расширяет IWMDRMDeviceApp , предоставляя новую версию метода QueryDeviceStatus .

 

Интерфейсы обратного вызова

Следующие необязательные интерфейсы реализуются приложением для отслеживания хода выполнения асинхронного запроса, например запроса на чтение или запись.

Интерфейс	Описание
IWMDMNotification	Позволяет приложениям и поставщикам услуг получать уведомления, когда устройства или хранилища памяти (например, карты ОЗУ) подключены к компьютеру или отключены от них.
IWMDMOperation2	Расширяет IWMDMOperation , предоставляя методы для получения и задания расширенных атрибутов.
IWMDMOperation3	Расширяет IWMDMOperation , предоставляя новый метод для передачи незашифрованных данных для повышения эффективности.
IWMDMOperation	Позволяет приложению управлять тем, как данные считываются или записываются на компьютер во время передачи файлов.
IWMDMProgress2	Расширяет метод IWMDMProgress::End , предоставляя индикатор состояния.
IWMDMProgress3	Расширяет IWMDMProgress2 , предоставляя дополнительные входные параметры для указания идентификатора события и контекстной информации.
IWMDMProgress	Позволяет приложению отслеживать ход выполнения операций, таких как форматирование мультимедиа или передача файлов.

 

На следующей схеме показано, как большинство важных интерфейсов приложений извлекаются из корневого интерфейса IWMDeviceManager . Приложение получает этот корневой интерфейс путем совместного построения объекта MediaDevMgr, запроса интерфейса IComponentAuthenticate , проверки подлинности компонента, а затем запроса IWMDeviceManager (эти действия описаны в разделе Проверка подлинности приложения). После получения этого корневого интерфейса вызывается IWMDeviceManager::EnumDevices для создания объекта, реализующего IWMDMEnumDevice. Другие интерфейсы получаются путем вызова методов для интерфейсов в указанном порядке. Производные интерфейсы, такие как IWMDMDevice2 , получаются путем вызова QueryInterface в базовом интерфейсе.

На следующей схеме производные интерфейсы помечены знаками косой черты, поэтому "IWMDMStorage/2/3" будет означать IWMDMStorage, IWMDMStorage2 и IWMDMStorage3.

Связанные темы

Справочник по программированию