SyncState 屬性

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

SyncState屬性是 32 位值的字串標記法，Windows 媒體播放機同步處理播放清單與可攜式裝置時使用。

套用至

備註

此屬性包含十六個 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