estrutura VDS_DISK_PROP (vds.h)

Artigo
03/08/2023

[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 disco.

Sintaxe

typedef struct _VDS_DISK_PROP {
  VDS_OBJECT_ID        id;
  VDS_DISK_STATUS      status;
  VDS_LUN_RESERVE_MODE ReserveMode;
  VDS_HEALTH           health;
  DWORD                dwDeviceType;
  DWORD                dwMediaType;
  ULONGLONG            ullSize;
  ULONG                ulBytesPerSector;
  ULONG                ulSectorsPerTrack;
  ULONG                ulTracksPerCylinder;
  ULONG                ulFlags;
  VDS_STORAGE_BUS_TYPE BusType;
  VDS_PARTITION_STYLE  PartitionStyle;
  union {
    DWORD dwSignature;
    GUID  DiskGuid;
  };
  LPWSTR               pwszDiskAddress;
  LPWSTR               pwszName;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszAdaptorName;
  LPWSTR               pwszDevicePath;
} VDS_DISK_PROP, *PVDS_DISK_PROP;

Membros

id

O GUID do objeto de disco.

status

A disponibilidade de um disco físico enumerado por VDS_DISK_STATUS. Se o serviço VDS não puder abrir um identificador para o disco, ele definirá esse membro como VDS_DS_UNKNOWN.

Nota Esse membro pode ser VDS_DS_ONLINE, mesmo que o status do pacote contido seja VDS_PS_OFFLINE.

ReserveMode

Este membro é reservado para uso futuro.

health

Um VDS_HEALTH valor de enumeração que especifica o estado de integridade do disco. Veja a seguir os valores válidos para esse membro.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

O tipo de dispositivo definido em Winioctl.h, que inclui os seguintes tipos, entre outros:

dwMediaType

Um tipo de mídia enumerado por STORAGE_MEDIA_TYPE. Os discos básicos e dinâmicos são mapeados para o enumerador FixedMedia . Para obter mais informações, consulte STORAGE_MEDIA_TYPE.

ullSize

O tamanho do disco em bytes. Para determinar o tamanho máximo do volume de um disco, chame IVdsDisk3::QueryFreeExtents e adicione os tamanhos de todas as extensões livres.

ulBytesPerSector

O número de bytes em cada setor.

ulSectorsPerTrack

O número de setores em cada faixa.

ulTracksPerCylinder

O número de faixas em cada cilindro.

ulFlags

Uma máscara de bits de VDS_DISK_FLAG valores de enumeração que especificam vários atributos de disco.

BusType

Os tipos de barramento de entrada/saída enumerados por VDS_STORAGE_BUS_TYPE.

PartitionStyle

Um VDS_PARTITION_STYLE valor de enumeração que especifica o tipo de partição. Este membro é o discriminador da união.

dwSignature

Usado se PartitionStyle for VDS_PST_MBR (1). A assinatura da partição MBR. Não há garantia de que esse valor seja exclusivo.

DiskGuid

Usado se PartitionStyle for VDS_PST_GPT (2). O GUID do disco. Além disso, cada partição GPT tem seu próprio GUID. (Consulte VDS_PARTITION_INFO_GPT.)

pwszDiskAddress

O endereço de um disco semelhante a SCSIno formatoNNN De destinoNNN NNNDe destinoNNN, em que NNN é um ou mais dígitos.

Discos SCSI, discos IDE e discos fibre channel podem ter esse endereço. Os discos USB e 1394 têm formatos de endereço diferentes e não são armazenados.

Esse membro é opcional e pode ser NULL se nenhum valor estiver disponível. Se não for NULL, seu comprimento deverá ser maior ou igual a 22 WCHAR e menor ou igual a 64 WCHAR, incluindo o terminador NULL necessário. Os aplicativos que recebem a estrutura VDS_DISK_PROP chamando IVdsDisk::GetProperties devem verificar se esse membro é NULL.

pwszName

O nome usado para abrir um identificador para um objeto criado usando a função CreateFile . Por exemplo: \\?\PhysicalDrive2

pwszFriendlyName

O nome retornado pelo Gerenciador de Plug and Play. Esse nome é mantido no Registro do Windows pelo Gerenciador de Plug and Play, por exemplo: "SEAGATE ST34573N SCSI Disk Device".

pwszAdaptorName

O nome do adaptador ao qual esse disco está anexado. O Gerenciador de Plug and Play retorna o nome, que é mantido no registro do Windows, por exemplo: "Adaptec AHA-2940U2W - Ultra2 SCSI".

pwszDevicePath

A cadeia de caracteres retornada pelo Gerenciador de Plug and Play. O Gerenciador de Plug and Play usa o caminho do dispositivo para identificar exclusivamente um dispositivo em um computador. Para obter mais informações, consulte SP_DEVICE_INTERFACE_DETAIL_DATA_W.

Comentários

O método IVdsDisk::GetProperties retorna o valor dessa estrutura para relatar as propriedades de um objeto de disco.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	vds.h