元数据常量

元数据是有关传输到设备或从设备传输的内容的描述性信息。 在 Windows 媒体设备管理器中,元数据由属性组成,其中每个属性都是名称值对。 名称始终是宽字符字符串。 该值是 WMDM_TAG_DATATYPE 枚举中所述的几种定义的数据类型之一。

Windows 媒体设备管理器具有预定义的常用属性,强烈建议你改用这些属性来定义新属性。 对于每个预定义属性,SDK 定义一个包含名称字符串的全局常量。 可以使用全局常量减少版式错误的可能性。 例如,常量g_wszWMDMTitle定义为“Title”,对应于 Title 属性。

已定义以下元数据属性常量以用于此 SDK。 这些定义在 mswmdm.h 中。

存储元数据常量

存储属性 描述 Windows 媒体设备管理器类型 基础类型
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 专辑艺术 JPEG 字节 blob WMDM_TYPE_BINARY BYTE*
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_wszWMDMBitrate 音频比特率 WMDM_TYPE_DWORD DWORD
g_wszWMDMBitrateType MTP 比特率类型。 (当前未实现)。有效值为:
MTP_BITRATETYPE_DISCRETE(0x001),指示支持 CBR 和一组离散比特率。
指示对 VBR 的支持的 MTP_BITRATETYPE_VARIABLE(0x0002)。
MTP_BITRATE_TYPE_FREE(0x0003),指示 CBR 和比特率值在指定范围内是连续的。
WMDM_TYPE_DWORD DWORD
g_wszWMDMBlockAlignment 块对齐 WMDM_TYPE_DWORD DWORD
g_wszWMDMBufferSize 缓冲区大小 WMDM_TYPE_DWORD DWORD
g_wszWMDMBuyNow 购买此专辑(专辑艺术需要) WMDM_TYPE_BOOL BOOL
g_wszWMDMByteBookmark 一个书签,用于标识在媒体对象中播放或查看的最后一个位置。 (此书签是从零开始的字节偏移量。) 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 文件名。 等效于调用 IWMDMStorage::GetName WMDM_TYPE_STRING LPCWSTR
g_wszWMDMFileSize 文件大小(以字节为单位)。 等效于调用 IWMDMStorage::GetSize WMDM_TYPE_QWORD QWORD
g_wszWMDMFormatCode 设置内容格式的代码的格式。 它应该是一个 WMDM_FORMATCODE值。
WMDM_TYPE_DWORD WMDM_FORMATCODE
g_wszWMDMFrameRate 帧速率 WMDM_TYPE_DWORD DWORD
g_wszWMDMGenre Track 的流派 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMHeight 视频或图像高度 WMDM_TYPE_DWORD DWORD
g_wszWMDMIsProtected 内容是否受 DRM 保护 WMDM_TYPE_BOOL BOOL
g_wszWMDMIsRepeat 如此 如果不是第一次播出情节 WMDM_TYPE_BOOL BOOL
g_wszWMDMKeyFrameDistance 关键帧距离 WMDM_TYPE_DWORD DWORD
g_wszWMDMLastModifiedDate 上次修改日期/时间文件。 等效于调用 IWMDMStorage::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 派生自主要 & 辅助类 ID 的内容类型 WMDM_TYPE_STRING LPCWSTR
g_wszWMDMNonConsumable 内容是否以不透明数据 Blob 的形式存储在设备上。 如果是这样,设备不需要了解格式或呈现格式。 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 设备生成的唯一 ID 用于存储 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 Track 的心情 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

设备元数据常量

Device 属性 描述 PROPVARIANT 类型(vt) 评论
g_wszWMDMSupportedDeviceProperties 设备支持的属性的属性名称数组 VT_BSTR |VT_ARRAY
g_wszWMDMDeviceFriendlyName 设备的友好名称 VT_BSTR
g_wszWMDMFormatsSupported 设备支持的格式格式代码数组 VT_UI4 |VT_ARRAY
g_wszWMDMFormatsSupportedAreOrdered 指示是否根据设备首选项对支持格式数组中返回的格式进行排序。如果此属性设置为 TRUE,则应用程序应使用数组中第一个显示的格式代码传输内容。
VT_BOOL
g_wszWMDMSyncRelationshipID 应用程序使用的同步关系 ID 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 媒体设备管理器服务提供商的供应商的 ID 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 可移植设备属性 描述 PROPVARIANT 类型(vt) 评论
g_wszWPDPassthroughPropertyValues 用于设置或检索 Windows 可移植设备属性的二进制大型对象(或 BLOB) WMDM_TYPE_BINARY 允许 Windows 媒体设备管理器客户端读取和写入 Windows Media Device Manager 中未找到的 Windows 可移植设备属性。请注意,某些 Windows 可移植设备属性可能无法访问。

编程参考