库位置常量

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店上下文之外使用此功能。

 

库位置常量是在 contentpartner.h 中定义的全局字符串变量。 它们由 IWMPContentPartner 和 IWMPContentPartnerCallback 接口的某些方法以及 External 对象的某些方法使用。 这些常量用于指示以下类型。

  • 库位置类型：这是Windows 媒体播放器显示的库视图类型。 例如，Player 可能正在显示特定专辑 (g_szCPAlbumID) 视图或 (g_szAllCPGenreIDs) 所有流派的视图。
  • 所选项目类型：这是在库视图中选择的项的类型。 例如，用户可以在所有相册的视图中选择特定相册 (g_szCPAlbumID) 。
  • 列表类型：这是从内容合作伙伴插件请求的列表类型。 例如，Windows 媒体播放器可能会要求插件提供与特定播放列表 (g_szCPListID) 关联的项目列表。
  • 列表项类型：从内容合作伙伴插件请求的单个列表项的类型。 例如，Windows 媒体播放器可能会要求插件提供特定播放列表中 (g_szCPTrackID) 曲目列表。

下表提供了每个常量的名称和值，以及库位置或类型的简要说明。 在使用 contentpartner.h 头文件编译的 C 或 C++ 代码中，可以使用常量的名称或值。 最好使用 名称，因为编译器将检测拼写错误。 例如，在脚本 (调用 External 对象的方法) 时，不能使用常量的名称;必须使用 值。

名称 值 位置或类型
g_szUnknownLocation UnknownLocation 既不是专辑也不是播放列表的一组曲目。 Windows 媒体播放器在无法确定有效位置的罕见事件中也使用此常量。
g_szRootLocation RootLocation 库树视图控件中的顶部节点
g_szFlyoutMenu FlyoutMenu 当前在线商店的浮出控件菜单
g_szOnlineStore OnlineStore 所有在线商店
g_szCPListID CPListID 单个列表
g_szAllCPListIDs AllCPListIDs 所有列表
g_szCPTrackID CPTrackID 单个曲目
g_szAllCPTrackIDs AllCPTrackIDs 所有曲目
g_szCPArtistID CPArtistID 个人艺术家
g_szAllCPArtistIDs AllCPArtistIDs 所有艺术家
g_szCPAlbumID CPAlbumID 个人相册
g_szAllCPAlbumIDs AllCPAlbumIDs 所有相册
g_szCPGenreID CPGenreID 单个流派
g_szAllCPGenreIDs AllCPGenreIDs 所有流派
g_szCPAlbumSubGenreID CPAlbumSubGenreID 单个子元素
g_szAllCPAlbumSubGenreIDs AllCPAlbumSubGenreIDs 所有子根
g_szReleaseDateYear ReleaseDateYear 发布目录内容的单个年份
g_szAllReleaseDateYears AllReleaseDateYears 发布目录内容的所有年份
g_szCPRadioID CPRadioID 单个无线电流
g_szAllCPRadioIDs AllCPRadioIDs 所有无线电流
g_szAuthor 作者 单个作者
g_szAllAuthors AllAuthors 所有作者
g_szWMParentalRating WMParentalRating 个人家长分级
g_szAllWMParentalRatings AllWMParentalRatings 所有家长分级
g_szUserEffectiveRatingStars UserEffectiveRatingStars 单个用户评分，以星数度量
g_szAllUserEffectiveRatingStarss AllUserEffectiveRatingStarss 所有用户分级

 

External.addToBasket

External.buy

External.changeView

External.changeViewOnlineList

External.download

External.libraryLocationType

External.play

IWMPContentPartner：：GetCommands

IWMPContentPartner：：GetListContents

IWMPContentPartner：：GetTemplate

IWMPContentPartner：：InvokeCommand

IWMPContentPartnerCallback：：ChangeView