Константы метаданных
Метаданные — это описательные сведения о содержимом, переданном на устройство или с устройства. В диспетчер устройств Windows Media метаданные состоят из свойств, где каждое свойство является парой "имя-значение". Имя всегда является строкой широкого символа. Это значение является одним из нескольких определенных типов данных, описанных в перечислении WMDM_TAG_DATATYPE.
Windows Media диспетчер устройств имеет предопределенные общие свойства и настоятельно рекомендуется использовать их вместо определения новых. Для каждого предопределенного свойства пакет SDK определяет глобальную константу, содержащую строку имени. Вы можете уменьшить вероятность типографических ошибок с помощью глобальной константы. Например, константный g_wszWMDMTitle определяется как Title, соответствующий свойству Title.
Для использования в этом пакете SDK определены следующие константы свойств метаданных. Они определены в mswmdm.h.
Константы метаданных служба хранилища
| свойство служба хранилища | Description | Тип диспетчер устройств Windows Media | Базовый тип |
|---|---|---|---|
| g_wszAudioWAVECodec | Аудиокодек | WMDM_TYPE_DWORD | DWORD |
| g_wszVideoFourCCCodec | Видеокодек | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumArt | Независимо от того, поддерживает ли устройство искусство альбомов | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Артисты альбома трека | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Байт байтового blob-объекта JPEG | WMDM_TYPE_BINARY | БАЙТ* |
| g_wszWMDMAlbumCoverDuration | Длительность обложки альбома | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Формат искусства альбомов | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Высота искусства альбомов | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Размер коллекции альбомов | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Ширина рисунка альбома | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Название альбома трека | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Глубина бита звука | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Ссылка на объект контейнера. Например, звуковой объект будет использовать это свойство для ссылки на список воспроизведения. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Автор содержимого | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthorDate | Дата создания содержимого | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDМБ itrate | Скорость аудиобитовой передачи | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDМБ itrateType | Тип скорости скорости MTP. (В настоящее время не реализовано.) Допустимые значения: MTP_BITRATETYPE_DISCRETE (0x001), указывающее, что CBR и дискретный набор скоростей поддерживаются. MTP_BITRATETYPE_VARIABLE (0x0002), указывающее поддержку VBR. MTP_BITRATE_TYPE_FREE (0x0003), указывающее, что значения CBR и скорости скорости непрерывно выполняются по указанному диапазону. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDМБ lockAlignment | Выравнивание блоков | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDМБ ufferSize | Размер буфера | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDМБ uyNow | Приобретите этот альбом (требуется для альбомного искусства) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDМБ yteBookmark | Закладка, определяющая последнюю позицию, воспроизводимую или просматриваемую в объекте мультимедиа. (Эта закладка представляет собой смещение байтов на основе нуля.) | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMCategory | Текстовое поле, указывающее жанр элемента мультимедиа | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMCodec | Зарезервировано для будущего использования | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMComposer | Музыкальный композитор | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | Длина данных для объекта, на который ссылается ссылка | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataOffset | Отсчитываемый от нуля смещение к объекту, на который ссылается ссылка | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | Единицы, используемые для длины данных (g_wszWMDMDataLength) и свойств единиц данных (g_wszWMDMDataUnits). Предполагается, что единицы будут байтами, если это свойство не задано. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | Телесериал или фото описание | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | URL-адрес, связанный с объектом. Обычно это свойство используется для объекта приведения мультимедиа (или связанного). |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMRMId | Зарезервировано для будущего использования | ||
| g_wszWMDMDevicePlayCount | Количество воспроизведения на устройстве | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDuration | Длительность мультимедиа в единицах 100 ns | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | Адрес электронной почты для редактора управления, связанного с объектом мультимедиа. Обычно это свойство используется для идентификации управляемого редактора для канала RSS. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMEncodingProfile | Профили кодирования WMV9, поддерживаемые устройством | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Атрибуты объекта файла | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Музыка, видео, не музыкальный звук, другие | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Дата создания файла | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Имя файла. Эквивалент вызова IWMDM служба хранилища::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Размер файла в байтах. Эквивалент вызова IWMDM служба хранилища::GetSize. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMFormatCode | Форматирование кода для формата содержимого. Это должно быть WMDM_FORMATCODEзначение. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Частота кадров | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMGenre | Жанр трека | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMHeight | Высота видео или изображения | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMIsProtected | Защита содержимого DRM | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMIsRepeat | True, если не первый эпизод проветрился | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMKeyFrameDistance | Расстояние от ключевого кадра | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | Файл даты и времени был изменен в последний раз. Эквивалент вызова IWMDM служба хранилища::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaClassSecondaryID | Аудио книги, музыкальные видео, разговор радио и т. д. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | Телевизионные кредиты (актеры, режиссер, продюсеры) | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaGuid | Глобальный уникальный идентификатор содержимого мультимедиа | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaOriginalBroadcastDateTime | Дата первого эфира эпизода | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Канал, который эпизод был записан из | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Тв-станция называет буквы или имя | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Тип контента, производный от первичного и вторичного идентификатора класса | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Хранится ли содержимое как непрозрачный большой двоичный объект данных на устройстве. В этом случае устройство не требует понимания формата или отрисовки. | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMNumChannels | Количество каналов | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMObjectBookmark | Закладка (в миллисекундах), указывающая последнюю позицию в объекте мультимедиа, который был воспроизведен или просмотрован | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMOwner | Адрес электронной почты владельца объекта мультимедиа | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Рейтинг рекомендаций | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | Созданный устройством уникальный идентификатор для хранения | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Общее количество воспроизведения файлов | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Имя владельца авторских прав | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Настройка качества | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Частота выборки | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Тип сканирования | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSourceURL | Исходный URL-адрес объекта мультимедиа | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitle | Название телевизионного эпизода | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitleDescription | Описание телевизионного эпизода | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncID | Созданный приложением GUID для синхронизации | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncTime | Метка времени устройства при копировании | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Закладка (в миллисекундах), указывающая последнюю позицию, которую играли или просматривали | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | Время (в минутах) до обновления содержимого | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Заголовок отслеживания | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Общая скорость битов | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Номер трека (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Настроение трека | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Вычисляется от пользователей, рейтингов служб и количества воспроизведения | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Последнее прослушивание или просмотр метки времени | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Оценка набора пользователей | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Оценка набора пользователей изменилась на устройстве | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Скорость передачи видео | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | Адрес электронной почты веб-мастера, ответственного за объект мультимедиа | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMWidth | Ширина видео или изображения | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMYear | Год, в который был выпущен альбом | WMDM_TYPE_STRING | LPCWSTR |
Константы метаданных устройства
| Свойство устройства | Description | ProPVARIANT type(vt) | Комментарии |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Массив имен свойств для свойств, поддерживаемых устройством | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Понятное имя устройства | VT_BSTR | |
| g_wszWMDMFormatsSupported | Массив кодов формата для форматов, поддерживаемых устройством | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Указывает, упорядочен ли формат, возвращаемый в массиве поддерживаемых форматов, в соответствии с предпочтениями устройства. Если для этого свойства задано значение TRUE, приложения должны передавать содержимое с помощью кодов формата, которые отображаются сначала в массиве. |
VT_BOOL. | |
| g_wszWMDMSyncRelationshipID | Идентификатор связи синхронизации, используемый приложением | VT_BSTR | |
| g_wszWMDMDeviceModelName | Имя модели устройства | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Версия встроенного ПО | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Расширение поставщика, поддерживаемого устройством | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Протокол, используемый для обмена данными между узлом и устройством | VT_CLSID | Предопределенные значения: WMDM_DEVICE_PROTOCOL_MTP, WMDM_DEVICE_PROTOCOL_RAPI, WMDM_DEVICE_PROTOCOL_MSC |
| g_wszWMDMDeviceServiceProviderVendor | Идентификатор поставщика, предоставляющего поставщику услуг Windows Media диспетчер устройств для устройства | VT_CLSID | Предопределенные значения: WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Зарезервировано для последующего использования. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | Сведения об отзыве устройства. Эти сведения включают такие элементы, как URL-адрес отзыва. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Массив имен свойств для свойств, поддерживаемых устройством | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Понятное имя устройства | VT_BSTR |
Константы метаданных переносимых устройств Windows
| Свойство Переносимых устройств Windows | Description | ProPVARIANT type(vt) | Комментарии |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Двоичный большой объект (или БОЛЬШОЙ ДВОИЧНЫй объект), используемый для задания или получения свойств переносимых устройств Windows | WMDM_TYPE_BINARY | Позволяет клиентам Windows Media диспетчер устройств читать и записывать свойства переносимых устройств Windows, которые не найдены в диспетчер устройств Windows Media. Обратите внимание, что некоторые свойства переносимых устройств Windows могут быть недоступны. |