SyncState 属性

  • 项目

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

SyncState 属性是 32 位值的字符串表示形式，Windows 媒体播放器在将播放列表与便携式设备同步时使用。

应用于

备注

此属性由 16 个 2 位值组成，每个值指定便携式设备的同步状态。 此 32 位值的最大有效位 (MSB) 对应于设备 16。 LSB) 最低有效位 (对应于设备 1。

每个 2 位值的 MSB 指示Windows 媒体播放器内容是否与相应的设备同步。 值为 1 表示它已这样做。 值为 0 表示它没有。

如果 MSB 为 0，则 LSB 指定同步失败的原因。 LSB 中的值 1 表示内容没有足够的可用空间。 LSB 中的值 0 表示阻止同步的其他原因。

若要检索给定设备的同步状态，应执行以下操作：

  1. 调用 IWMPSyncDevice：：get_status 以确定给定设备是否已同步。
  2. 如果已同步，请调用 IWMPSyncDevice：：get_partnershipIndex 以在 SyncState 属性中检索设备的位对的索引。
  3. 使用此索引，屏蔽 SyncState 属性的相应位对，并检查结果以确定播放列表与设备的同步状态。

若要确定是否可以更改此属性的值，请使用 Media.isReadOnlyItem 方法。

要求

要求 值
版本
 Windows 媒体播放器 10 或更高版本

另请参阅

属性引用

确定播放列表同步状态

IWMPSyncDevice：：get_partnershipIndex

IWMPSyncDevice：：get_status