Interface IMDSPEnumStorage (mswmdm.h)
L’interface IMDSPEnumStorage est utilisée pour énumérer le support de stockage sur un appareil. Pour plus d’informations sur l’implémentation standard des interfaces d’énumération, consultez la documentation Microsoft COM, disponible sur le site Web de Microsoft. Les supports de stockage d’un appareil sont organisés de manière hiérarchique similaire aux lecteurs de disque d’un ordinateur.
Lorsqu’elle est accessible à partir de la méthode IMDSPDevice ::EnumStorage , cette interface énumère le support de stockage individuel sur l’appareil de la même manière que les lecteurs de disque individuels sur un ordinateur.
Lorsqu’elle est accessible à partir de la méthode IWMDMStorage ::EnumStorage , cette interface énumère le contenu du support de stockage. EnumStorage peut être appelé sur les objets de stockage énumérés de manière récursive, de sorte que le contenu d’un support de stockage est retourné de la manière hiérarchique dans laquelle ils sont stockés sur le support de stockage. Si le système de fichiers du support de stockage prend en charge une notion d’ordre entre le contenu, l’énumérateur retourne le contenu dans le même ordre.
L’énumérateur de stockage retourne une instantané de l’état des stockages. Il peut ne pas refléter l’effet de l’insertion et de la suppression du support de stockage et ne pas refléter les effets des méthodes Insert, Move et Delete suivantes. Le client doit obtenir un nouvel énumérateur pour obtenir le nouvel état du support de stockage.
Les méthodes Insert, Move et Delete de l’interface IWMDMStorageControl modifient l’ordre des fichiers. Si ces opérations sont appelées, l’ordre des objets retournés à l’origine par l’interface IMDSPEnumStorage peut être modifié.
Si une application doit afficher l’ordre du contenu sur un appareil multimédia, le programmeur de l’application doit prendre en compte les modifications d’ordre qui peuvent se produire à la suite des opérations IWMDMStorageControl . Il existe deux façons de faire face à cette situation. L’une des façons consiste simplement à réinscrire chaque fois qu’une modification du contenu se produit. Une autre méthode consiste à maintenir l’ordre des objets IWMDMStorage par programmation.
Quelle que soit la façon dont ce problème est géré, il doit être géré par l’application si l’ordre des fichiers est important pour l’application.
Héritage
L’interface IMDSPEnumStorage hérite de l’interface IUnknown. IMDSPEnumStorage possède également les types de membres suivants :
Méthodes
L’interface IMDSPEnumStorage possède ces méthodes.
| IMDSPEnumStorage ::Clone La méthode Clone crée un autre énumérateur qui contient le même état d’énumération que celui actuel. (IMDSPEnumStorage.Clone) |
| IMDSPEnumStorage ::Next La méthode Next retourne un pointeur vers les interfaces celtIMDSPStorage suivantes. |
| IMDSPEnumStorage ::Reset La méthode Reset réinitialise la séquence d’énumération au début. Un appel suivant à la méthode Next extrait la première interface de stockage de la séquence d’énumération. |
| IMDSPEnumStorage ::Skip La méthode Skip ignore le nombre spécifié suivant d’interfaces de stockage dans la séquence d’énumération. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |