Objets d’assistance

  • Article

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]

VDS fournit deux objets d’assistance : l’objet énumération et l’objet asynchrone. Cette rubrique décrit chacun de ces objets et fournit des liens vers des exemples de fonctionnement des appelants avec chacun d’eux.

Objet Énumération

Un objet d’énumération énumère un ensemble d’objets VDS d’un type donné. Les objets peuvent être des fournisseurs, des sous-systèmes, des contrôleurs, des LUN, des plex de LUN, des lecteurs, des packs de disques, des disques, des volumes ou des plex de volumes. Les appelants peuvent obtenir un pointeur vers un objet spécifique en sélectionnant l’objet souhaité dans l’énumération retournée par la méthode appropriée. Pour obtenir un exemple de code, consultez Utilisation d’objets d’énumération.

Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.

Type Élément
Interfaces qui sont toujours exposées par cet objet IEnumVdsObject
Énumérations associées Aucune.
Structures associées Aucune.

 

Objet asynchrone

Un objet asynchrone gère les opérations asynchrones. Les méthodes qui lancent des opérations asynchrones retournent un pointeur vers une interface IVdsAsync , ce qui permet à l’appelant d’annuler, d’attendre et d’interroger l’état de l’opération asynchrone.

Les opérations VDS de longue durée ont tendance à être implémentées de manière asynchrone. Les programmes de fournisseur de logiciels de base et dynamiques implémentent des méthodes asynchrones de manière cohérente pour les opérations de volume, de partition et de disque. Les fournisseurs de matériel implémentent éventuellement des méthodes asynchrones associées. Quelle que soit la façon dont le fournisseur implémente la méthode, l’opération doit renvoyer un pointeur vers une interface IVdsAsync vers l’appelant. Pour obtenir un exemple de code, consultez Gestion des opérations asynchrones.

Les opérations asynchrones sont les suivantes :

  • Création d’une LUN, d’un volume ou d’une partition.
  • Mise en forme d’un volume ou d’une partition.
  • Ajout ou suppression d’une LUN ou d’un plex de volume.
  • Cassant un plex de volume.
  • Extension ou réduction d’une LUN ou d’un volume.
  • Récupération d’une LUN ou d’un volume.
  • Nettoyage d’un disque.
  • Remplacement d’un disque.

Le tableau suivant répertorie les interfaces, les énumérations et les structures associées.

Type Élément
Interfaces qui sont toujours exposées par cet objet IVdsAsync
Énumérations associées Aucune.
Structures associées Aucune.

 

Modèle objet VDS

IVdsAsync

Utilisation d’objets d’énumération

Gestion des opérations asynchrones