元数据常量
元数据是有关传输到设备或从设备传输的内容的描述性信息。 在 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 可移植设备属性可能无法访问。 |