estrutura VDS_VOLUME_PROP2 (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 volume. Essa estrutura é idêntica à estrutura de VDS_VOLUME_PROP , exceto que também inclui os GUIDs de volume.

Sintaxe

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

Membros

id

O GUID do volume.

type

Um VDS_VOLUME_TYPE valor de enumeração que especifica o tipo de volume. Os tipos de volume são simples, estendidos, distribuídos (RAID-0), espelhados ou distribuídos com paridade (RAID-5).

status

Um VDS_VOLUME_STATUS valor de enumeração que especifica o status do volume.

health

Um VDS_HEALTH valor de enumeração que especifica o estado de integridade do volume.

TransitionState

Um VDS_TRANSITION_STATE valor de enumeração que especifica o estado de transição do volume.

ullSize

O tamanho do volume, em bytes.

ulFlags

Uma máscara de bits de VDS_VOLUME_FLAG valores de enumeração que descrevem o volume.

RecommendedFileSystemType

Um VDS_FILE_SYSTEM_TYPE valor de enumeração que especifica o sistema de arquivos preferencial para o volume. Deve ser um dos seguintes: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS ou VDS_FST_UNKNOWN.

cbUniqueId

O comprimento da matriz de bytes para o qual o membro pUniqueId aponta.

pwszName

O nome que foi usado para abrir um identificador para o volume com a função CreateFile . Por exemplo, \?\GLOBALROOT\Device\HarddiskVolume1.

pUniqueId

Uma matriz de bytes que contém o identificador exclusivo para o volume.

Comentários

O método IVdsVolume2::GetProperties2 retorna essa estrutura para relatar as propriedades de um objeto de volume.

Quando um volume está offline, o sinalizador VDS_VF_PERMANENTLY_DISMOUNTED é definido no membro ulFlags da estrutura VDS_VOLUME_PROP2 e o valor status volume VDS_VS_OFFLINE também é definido no membro status dessa estrutura.

Para GPT e volumes dinâmicos, o identificador exclusivo para o qual o membro pUniqueId aponta é globalmente exclusivo.

Para unidades de mídia removíveis, o volume existe e tem seu próprio identificador exclusivo, mesmo que não haja mídia no dispositivo. Se um volume for formatado em mídia removível, esse volume terá seu próprio identificador exclusivo. Para obter mais informações, consulte Suporte a solicitações do Mount Manager em um driver de classe de armazenamento.

O formato do identificador exclusivo pode variar entre diferentes tipos de dispositivos e volumes. Para volumes básicos em discos MBR, o identificador exclusivo é baseado na assinatura de disco e no deslocamento de partição. Como a assinatura de disco e o deslocamento de partição são valores DWORD, não é possível garantir que o identificador exclusivo seja globalmente exclusivo entre computadores.

Se a assinatura de disco for alterada, o identificador exclusivo do volume também será alterado. As alterações de assinatura de disco geralmente ocorrem como resultado de uma colisão durante a clonagem de disco.

Observe que um identificador exclusivo não é o mesmo que um caminho GUID de volume. Para localizar os caminhos guid de volume para um volume, use o método IVdsVolumeMF3::QueryVolumeGuidPathnames .

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	vds.h