Partilhar via


Objetos auxiliares

[A partir do Windows 8 e do Windows Server 2012, o Virtual Disk Service interface COM é substituído pela API de Gerenciamento de Armazenamento do Windows.]

O VDS fornece dois objetos auxiliares: o objeto de enumeração e o objeto assíncrono. Este tópico descreve cada um desses objetos e fornece links para exemplos de como os chamadores trabalham com cada um.

Objeto de enumeração

Um objeto de enumeração enumera através de um conjunto de objetos VDS de um determinado tipo. Os objetos podem ser provedores, subsistemas, controladores, LUNs, plexes de LUN, drives, pacotes de discos, discos, volumes ou plexes de volume. Os chamadores podem obter um ponteiro para um objeto específico selecionando o objeto desejado na enumeração que é retornada pelo método apropriado. Para obter um exemplo de código, consulte Trabalhando com objetos de enumeração.

A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.

Tipo Elemento
Interfaces que são sempre expostas por este objeto IEnumVdsObject
Enumerações associadas Nenhuma.
Estruturas associadas Nenhuma.

 

Objeto assíncrono

Um objeto assíncrono gerencia operações assíncronas. Os métodos que iniciam operações assíncronas retornam um ponteiro para uma interfaceIVdsAsync, que permite que o chamador cancele, aguarde e consulte o status da operação assíncrona.

As operações VDS de longa duração tendem a ser implementadas de forma assíncrona. Os programas básicos e dinâmicos do provedor de software implementam métodos assíncronos consistentemente para operações de volume, partição e disco. Opcionalmente, os provedores de hardware implementam métodos relacionados a assíncronos de forma assíncrona. Independentemente de como o provedor implementa o método, a operação deve retornar um ponteiro para um interface IVdsAsync para o chamador. Para obter um exemplo de código, consulte Gerenciando operações assíncronas.

As operações assíncronas incluem:

  • Criação de um LUN, volume ou partição.
  • Formatação de um volume ou partição.
  • Adicionar ou remover um LUN ou plex de volume.
  • Quebrando um plex de volume.
  • Extensão ou redução de um LUN ou volume.
  • Recuperação de um LUN ou volume.
  • Limpeza de um disco.
  • Substituindo um disco.

A tabela a seguir lista interfaces, enumerações e estruturas relacionadas.

Tipo Elemento
Interfaces que são sempre expostas por este objeto IVdsAsync
Enumerações associadas Nenhuma.
Estruturas associadas Nenhuma.

 

Modelo de objeto VDS

IVdsAsync

Trabalhando com objetos de enumeração

Gerenciando operações assíncronas