元数据常量
元数据是有关传输到设备或从设备传输的内容的描述性信息。 在 Windows Media 设备管理器 中，元数据由属性组成，其中每个属性都是名称/值对。 名称始终是宽字符字符串。 值是 WMDM_TAG_DATATYPE 枚举中所述的几种定义的数据类型之一。
Windows Media 设备管理器具有预定义的通用属性，强烈建议你改用这些属性来定义新属性。 对于每个预定义属性，SDK 定义一个包含名称字符串的全局常量。 通过使用全局常量，可以降低出现排版错误的可能性。 例如，常量g_wszWMDMTitle定义为“Title”，对应于 Title 属性。
已定义以下元数据属性常量以用于此 SDK。 这些定义在 mswmdm.h 中。
存储元数据常量
| 存储属性 | 说明 | 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 | 专辑封面 JPEG 字节 blob | 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_wszWMDMBitrate | 音频比特率 | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBitrateType | MTP 比特率类型。 (当前未实现。) 有效值为： MTP_BITRATETYPE_DISCRETE (0x001) ，指示支持 CBR 和一组离散比特率。 MTP_BITRATETYPE_VARIABLE 指示对 VBR 的支持的 (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 | 一个书签，用于标识在媒体对象中播放或查看的最后一个位置。 (此书签是从零开始的字节 offset.) | 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 | 曲目流派 | 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 | 上次修改日期/时间文件。 等效于调用 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 | 跟踪的心情 | 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 |
设备元数据常量
| 设备属性 | 说明 | 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 Media 设备管理器服务提供商的供应商的 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 Media 设备管理器客户端读取和写入 Windows Media 设备管理器中未找到的 Windows 可移植设备属性。请注意，某些 Windows 便携设备属性可能无法访问。 |