estrutura VDS_VOLUME_PROP2 (vds.h)
[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 |