Attribut SyncState

  • Article

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’attribut SyncState est une représentation sous forme de chaîne d’une valeur 32 bits que Lecteur multimédia Windows utilise lorsqu’il synchronise des playlists avec des appareils portables.

S'applique à

Notes

Cet attribut se compose de seize valeurs 2 bits, chacune spécifiant l’état de synchronisation d’un appareil portable. Le bit le plus significatif (MSB) de cette valeur de 32 bits correspond à l’appareil 16. Le bit le moins significatif (LSB) correspond à l’appareil 1.

Le MSB de chaque valeur 2 bits indique si Lecteur multimédia Windows synchronisé le contenu avec l’appareil correspondant. La valeur 1 indique que c’est le cas. La valeur 0 indique que ce n’est pas le cas.

Si le MSB est 0, le LSB spécifie la raison de l’échec de la synchronisation. La valeur 1 dans le LSB indique qu’il n’y avait pas suffisamment d’espace libre pour le contenu. La valeur 0 dans le LSB indique une autre raison pour laquelle la synchronisation a été empêchée.

Pour récupérer l’état de synchronisation d’un appareil donné, procédez comme suit :

  1. Appelez IWMPSyncDevice::get_status pour déterminer si un appareil donné est synchronisé.
  2. S’il est synchronisé, appelez IWMPSyncDevice::get_partnershipIndex pour récupérer l’index de la paire de bits de l’appareil dans l’attribut SyncState .
  3. À l’aide de cet index, masquez la paire de bits correspondante de l’attribut SyncState et examinez le résultat pour déterminer l’état de synchronisation de la playlist avec l’appareil.

Pour déterminer si vous pouvez modifier la valeur de cet attribut, utilisez la méthode Media.isReadOnlyItem .

Configuration requise

Condition requise Valeur
Version
 Lecteur multimédia Windows 10 ou version ultérieure

Voir aussi

Référence d’attribut

Détermination de l’état de synchronisation des playlists

IWMPSyncDevice::get_partnershipIndex

IWMPSyncDevice::get_status