estrutura VDS_DRIVE_PROP2 (vdshwprv.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define as propriedades de um objeto de unidade. Essa estrutura é idêntica à estrutura VDS_DRIVE_PROP , exceto que inclui o número do compartimento, o tipo de barramento e a velocidade do eixo como membros.

Sintaxe

typedef struct _VDS_DRIVE_PROP2 {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  ULONG                ulFlags;
  VDS_DRIVE_STATUS     status;
  VDS_HEALTH           health;
  SHORT                sInternalBusNumber;
  SHORT                sSlotNumber;
  ULONG                ulEnclosureNumber;
  VDS_STORAGE_BUS_TYPE busType;
  ULONG                ulSpindleSpeed;
} VDS_DRIVE_PROP2, *PVDS_DRIVE_PROP2;

Membros

id

O GUID do objeto de unidade.

ullSize

O tamanho da unidade, em bytes.

pwszFriendlyName

Uma cadeia de caracteres largos terminada em NULL que contém o nome da unidade.

pwszIdentification

Uma cadeia de caracteres largos terminada em NULL que contém o identificador de unidade.

ulFlags

Uma máscara de bits de
VDS_DRIVE_FLAG valores de enumeração.

status

A
VDS_DRIVE_STATUS valor de enumeração que especifica o status da unidade.

health

Um VDS_HEALTH valor de enumeração que especifica o status de integridade da unidade. Veja a seguir os valores válidos para esse membro.

Windows Server 2008, Windows Vista e Windows Server 2003: não há suporte para VDS_H_REPLACED e VDS_H_PENDING_FAILURE .

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE (10)

sInternalBusNumber

O número do barramento ao qual a unidade está conectada. Esse número é um valor atribuído pelo implementador que identifica exclusivamente o barramento dentro do subsistema. Ele não é restrito pelo número de ônibus que o subsistema contém e não está relacionado ao valor do membro sNumberOfInternalBuses da estrutura VDS_SUB_SYSTEM_PROP .

sSlotNumber

O número do slot que a unidade ocupa. Esse número é um valor atribuído pelo implementador que identifica exclusivamente o slot dentro do barramento. Ele não é restrito pelo número de slots que o barramento contém e não está relacionado ao valor do membro sMaxNumberOfSlotsEachBus da estrutura VDS_SUB_SYSTEM_PROP .

ulEnclosureNumber

O número do compartimento que contém a unidade. Um valor de ULONG_MAX indica que esse número não está definido para a unidade. Como alguns esquemas de numeração de compartimento são baseados em zero, zero é um valor válido para esse membro. Esse membro corresponde ao parâmetro ulEnclosureNumber do método IVdsSubSystem2::GetDrive2 .

busType

Um valor VDS_STORAGE_BUS_TYPE que especifica o tipo de barramento da unidade. Um valor zero significa que o tipo de barramento é desconhecido.

ulSpindleSpeed

A velocidade do eixo da unidade, em RPM. O valor padrão para esse membro é zero. Um valor zero significa que a velocidade do eixo é desconhecida. Um valor de 1 significa que a unidade não tem mídia rotativa. (Por exemplo, pode ser uma unidade de estado sólido.)

Comentários

Essa estrutura é usada pelo método IVdsDrive2::GetProperties2 para retornar as propriedades de um objeto de unidade.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho vdshwprv.h