VDS_DISK_PROP struttura (vds.h)

Articolo
03/08/2023

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

Sintassi

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;

Members

id

GUID dell'oggetto disco.

status

Disponibilità di un disco fisico enumerato da VDS_DISK_STATUS. Se il servizio VDS non può aprire un handle sul disco, imposta questo membro su VDS_DS_UNKNOWN.

Nota Questo membro può essere VDS_DS_ONLINE, anche se lo stato del pacchetto contenente è VDS_PS_OFFLINE.

ReserveMode

Questo membro è riservato per usi futuri.

health

Valore di enumerazione VDS_HEALTH che specifica lo stato di integrità del disco. Di seguito sono riportati i valori validi per questo membro.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

Il tipo di dispositivo definito in Winioctl.h, che include i tipi seguenti tra gli altri:

dwMediaType

Tipo di supporto enumerato da STORAGE_MEDIA_TYPE. I dischi di base e dinamici vengono mappati all'enumeratore FixedMedia . Per altre informazioni, vedere STORAGE_MEDIA_TYPE.

ullSize

Dimensioni del disco in byte. Per determinare le dimensioni massime del volume per un disco, chiamare IVdsDisk3::QueryFreeExtents e aggiungere le dimensioni di tutti gli extent gratuiti.

ulBytesPerSector

Numero di byte in ogni settore.

ulSectorsPerTrack

Numero di settori in ogni traccia.

ulTracksPerCylinder

Numero di tracce in ogni cilindro.

ulFlags

Maschera di bit di valori di enumerazione VDS_DISK_FLAG che specificano vari attributi del disco.

BusType

Tipi di bus di input/output enumerati da VDS_STORAGE_BUS_TYPE.

PartitionStyle

Valore di enumerazione VDS_PARTITION_STYLE che specifica il tipo di partizione. Questo membro è il discriminante per l'unione.

dwSignature

Usato se PartitionStyle è VDS_PST_MBR (1). Firma per la partizione MBR. Questo valore non è garantito essere univoco.

DiskGuid

Usato se PartitionStyle è VDS_PST_GPT (2). GUID per il disco. Inoltre, ogni partizione GPT ha il proprio GUID. Vedere VDS_PARTITION_INFO_GPT.

pwszDiskAddress

Indirizzo di un disco simile a SCSInel formatoNNN Percorso NNN NNNdi destinazioneNNN, doveNNNè una o più cifre.

I dischi SCSI, i dischi IDE e i dischi Fibre Channel possono avere tale indirizzo. I dischi USB e 1394 hanno formati di indirizzi diversi e non vengono archiviati.

Questo membro è facoltativo e può essere NULL se non è disponibile alcun valore. Se non è NULL, la lunghezza deve essere maggiore o uguale a 22 WCHAR e minore o uguale a 64 WCHAR, incluso il terminatore NULL richiesto. Le applicazioni che ricevono la struttura VDS_DISK_PROP chiamando IVdsDisk::GetProperties devono verificare se questo membro è NULL.

pwszName

Nome usato per aprire un handle a un oggetto creato usando la funzione CreateFile . ad esempio \\?\PhysicalDrive2

pwszFriendlyName

Nome restituito dal Plug and Play Manager. Questo nome viene mantenuto nel Registro di sistema di Windows dal Plug and Play Manager, ad esempio "SEAGATE ST34573N SCSI Disk Device".

pwszAdaptorName

Nome dell'adattatore a cui è collegato questo disco. Il Plug and Play Manager restituisce il nome, gestito nel Registro di sistema di Windows, ad esempio: "Adaptec AHA-2940U2W - Ultra2 SCSI".

pwszDevicePath

Stringa restituita da Plug and Play Manager. Il Plug and Play Manager usa il percorso del dispositivo per identificare in modo univoco un dispositivo in un computer. Per altre informazioni, vedere SP_DEVICE_INTERFACE_DETAIL_DATA_W.