SyncState-Attribut

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Das SyncState-Attribut ist eine Zeichenfolgendarstellung eines 32-Bit-Werts, der Windows Medienwiedergabe verwendet, wenn Wiedergabelisten mit tragbaren Geräten synchronisiert werden.

Gilt für

Bemerkungen

Dieses Attribut besteht aus sechzehn 2-Bit-Werten, von denen jeder den Synchronisierungsstatus eines tragbaren Geräts angibt. Das wichtigste Bit (MSB) dieses 32-Bit-Werts entspricht Gerät 16. Das am wenigsten signifikante Bit (LSB) entspricht Gerät 1.

Der MSB jedes 2-Bit-Werts gibt an, ob Windows Medienwiedergabe den Inhalt mit dem entsprechenden Gerät synchronisiert haben. Der Wert 1 gibt an, dass dies der Tat entspricht. Der Wert 0 gibt an, dass dies nicht der Wert war.

Wenn der MSB 0 ist, gibt der LSB an, warum bei der Synchronisierung ein Fehler aufgetreten ist. Der Wert 1 im LSB gibt an, dass nicht genügend freier Speicherplatz für den Inhalt vorhanden war. Der Wert 0 im LSB gibt einen anderen Grund an, aus dem die Synchronisierung verhindert wurde.

Gehen Sie wie folgt vor, um den Synchronisierungsstatus eines bestimmten Geräts abzurufen:

  1. Rufen Sie IWMPSyncDevice::get_status auf, um zu bestimmen, ob ein bestimmtes Gerät synchronisiert wird.
  2. Wenn es synchronisiert wird, rufen Sie IWMPSyncDevice::get_partnershipIndex auf, um den Index des Bitpaars des Geräts im SyncState-Attribut abzurufen.
  3. Maskieren Sie mit diesem Index das entsprechende Bitpaar des SyncState-Attributs , und untersuchen Sie das Ergebnis, um den Synchronisierungsstatus der Wiedergabeliste mit dem Gerät zu bestimmen.

Verwenden Sie die Media.isReadOnlyItem-Methode , um zu bestimmen, ob Sie den Wert dieses Attributs ändern können.

Anforderungen

Anforderung Wert
Version
 Windows Medienwiedergabe 10 oder höher

Siehe auch

Attributreferenz

Ermitteln des Wiedergabelistensynchronisierungsstatus

IWMPSyncDevice::get_partnershipIndex

IWMPSyncDevice::get_status