À propos du moteur de synchronisation

[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.]

Le moteur de synchronisation est le composant de Lecteur multimédia Windows qui gère la copie du contenu multimédia numérique sur des appareils portables. Lecteur multimédia Windows prend en charge une seule instance du moteur de synchronisation pour chaque appareil. Vous devez utiliser une instance distante du contrôle Lecteur multimédia Windows pour effectuer des tâches de synchronisation par programmation. En effet, votre programme partage les instances du moteur de synchronisation avec Lecteur multimédia Windows et tous les autres programmes qui utilisent les interfaces Player pour la synchronisation des appareils.

Vous pouvez utiliser IWMPSyncDevice::start et IWMPSyncDevice::stop pour contrôler le moment où le moteur de synchronisation effectue son travail. Dans la plupart des cas, vous ne devez pas utiliser ces méthodes. Au lieu de cela, vous devez laisser le moteur de synchronisation planifier son travail automatiquement. Les méthodes start et stop existent pour vous permettre de les utiliser si votre programme est conçu pour remplacer l’interface utilisateur Lecteur multimédia Windows. Dans ce cas, vous pouvez fournir un bouton démarrer/arrêter similaire à celui que Lecteur multimédia Windows fournit dans l’onglet Appareils.

Vous pouvez surveiller la progression de la synchronisation d’un appareil en interrogeant IWMPSyncDevice::get_progress. Cette méthode récupère une valeur de progression pour l’ensemble du processus de synchronisation avec un appareil particulier. La valeur récupérée est un nombre qui représente le pourcentage de synchronisation terminée. Vous pouvez recevoir deux événements liés à la synchronisation. L’événement DeviceSyncError vous avertit lorsqu’un problème se produit. L’événement DeviceSyncStateChange vous avertit lorsque le moteur de synchronisation a changé d’état pour l’appareil actuel.

Vous pouvez limiter la quantité de stockage d’appareil que Lecteur multimédia Windows utilise pour la synchronisation en appelant IWMPSyncDevice2::setItemInfo avec l’attribut PercentSpaceReserved. L’utilisation de cette interface nécessite Lecteur multimédia Windows 11.

Rubriques connexes

À propos de la synchronisation d’appareils

IWMPEvents2 Interface

Affichage de la progression de la synchronisation