À propos de la surveillance des dossiers

Lecteur Windows Media pouvez surveiller les dossiers qui contiennent des fichiers multimédias numériques et mettre à jour la bibliothèque lorsque des fichiers sont ajoutés ou supprimés. Cette fonctionnalité d’analyse des dossiers est fournie par l’interface IWMPFolderMonitorServices .

Pour utiliser les services de surveillance des dossiers, vous devez créer l’objet lecteur dans un État distant. pour plus d’informations sur la communication à distance, consultez communication à distance du contrôle Lecteur Windows Media. Après avoir créé une instance distante du lecteur, obtenez un pointeur vers l’interface IWMPFolderMonitorServices en appelant QueryInterface sur l’interface IWMPPlayer .

Lecteur Windows Media conserve une liste des dossiers en cours d’analyse. Pour obtenir la liste des dossiers analysés, utilisez les méthodes IWMPFolderMonitorServices :: obtenir _ Count et IWMPFolderMonitorServices :: Item . Pour ajouter des dossiers à la liste ou les supprimer de la liste, utilisez respectivement les méthodes IWMPFolderMonitorServices :: Add et Remove .

Démarrage d’une analyse

L’analyse des dossiers est normalement un processus en arrière-plan qui n’a pas besoin d’être appelé explicitement. Si vous souhaitez analyser activement un dossier, appelez IWMPFolderMonitorServices :: startScan. Vous pouvez arrêter une analyse en cours à l’aide de la méthode IWMPFolderMonitorServices :: stopScan .

Récupération de l’état d’analyse des dossiers

IWMPFolderMonitorServices fournit des fonctionnalités permettant de récupérer l’état du processus de surveillance du dossier.

L’analyse des dossiers est effectuée en deux étapes. Lors du premier passage, le lecteur analyse les dossiers nommés un par un dans la liste des dossiers analysés et génère une liste de fichiers à ajouter à la bibliothèque. Au cours de la deuxième passe, il parcourt la liste des fichiers et ajoute les fichiers à la bibliothèque, et supprime également tous les éléments multimédias de la bibliothèque dont les fichiers physiques correspondants ont été supprimés du système de fichiers.

L’événement FolderScanStateChange est utilisé pour notifier votre programme chaque fois que le lecteur passe à un nouvel État. Vous pouvez également récupérer l’état actuel en appelant la récupération _ scanState. Lors du démarrage de la première passe, la valeur de l’état actuel est wmpfssScanning. Pendant la deuxième passe, l’état passe à wmpfssUpdating. Une fois le processus terminé, l’état passe à wmpfssStopped.

Pendant que le lecteur analyse les dossiers analysés lors de la première passe, appelez la méthode obtenir _ scannedFilesCount pour vérifier le nombre de fichiers analysés. La méthode Obtient _ currentFolder vous indique quel dossier est actuellement en cours d’analyse.

Après le démarrage de la deuxième passe, appelez la méthode obtenir _ addedFilesCount pour vérifier le nombre de fichiers qui ont été ajoutés à la bibliothèque. La méthode obtenir _ UpdateProgress vous indiquera la progression de la deuxième passe, sous la forme d’un pourcentage compris entre 0 et 100.

À propos du modèle objet Player

Interface IWMPFolderMonitorServices