VDS_VOLUME_PROP2 struttura (vds.h)

Articolo
03/13/2024

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Definisce le proprietà di un oggetto volume. Questa struttura è identica alla struttura VDS_VOLUME_PROP , ad eccezione del fatto che include anche i GUID del volume.

Sintassi

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;

Members

id

GUID del volume.

type

Valore di enumerazione VDS_VOLUME_TYPE che specifica il tipo di volume. I tipi di volume sono semplici, con intervallo, con striping (RAID-0), con mirroring o con striping con parità (RAID-5).

status

Valore di enumerazione VDS_VOLUME_STATUS che specifica lo stato del volume.

health

Valore di enumerazione VDS_HEALTH che specifica lo stato di integrità del volume.

TransitionState

Valore di enumerazione VDS_TRANSITION_STATE che specifica lo stato di transizione del volume.

ullSize

Dimensioni del volume, in byte.

ulFlags

Maschera di bit di valori di enumerazione VDS_VOLUME_FLAG che descrivono il volume.

RecommendedFileSystemType

Valore di enumerazione VDS_FILE_SYSTEM_TYPE che specifica il file system preferito per il volume. Deve essere uno dei seguenti: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS o VDS_FST_UNKNOWN.

cbUniqueId

Lunghezza della matrice di byte a cui punta il membro pUniqueId .

pwszName

Nome utilizzato per aprire un handle per il volume con la funzione CreateFile . Ad esempio, \?\GLOBALROOT\Device\HarddiskVolume1.

pUniqueId

Matrice di byte che contiene l'identificatore univoco per il volume.

Commenti

Il metodo IVdsVolume2::GetProperties2 restituisce questa struttura per segnalare le proprietà di un oggetto volume.

Quando un volume è offline, il flag di VDS_VF_PERMANENTLY_DISMOUNTED viene impostato nel membro ulFlagsdella struttura VDS_VOLUME_PROP2 e il valore di stato del volume VDS_VS_OFFLINE viene impostato anche nel membro di stato di questa struttura.

Per i volumi GPT e dinamici, l'identificatore univoco a cui punta il membro pUniqueId è univoco a livello globale.

Per le unità multimediali rimovibili, il volume esiste e ha un proprio identificatore univoco anche se nel dispositivo non sono presenti supporti. Se un volume viene formattato su supporti rimovibili, tale volume ha un proprio identificatore univoco. Per altre informazioni, vedere Supporto delle richieste di Mount Manager in un driver di classe di archiviazione.

Il formato dell'identificatore univoco può variare tra diversi tipi di dispositivi e volumi. Per i volumi di base nei dischi MBR, l'identificatore univoco si basa sulla firma del disco e sull'offset di partizione. Poiché la firma del disco e l'offset di partizione sono valori DWORD, l'identificatore univoco non può essere garantito a livello globale in tutti i computer.

Se la firma del disco cambia, viene modificato anche l'identificatore univoco del volume. Le modifiche della firma del disco si verificano in genere in seguito a una collisione durante la clonazione del disco.

Si noti che un identificatore univoco non è uguale a un percorso GUID del volume. Per trovare i percorsi GUID del volume per un volume, usare il metodo IVdsVolumeMF3::QueryVolumeGuidPathnames .