struttura VDS_DRIVE_PROP2 (vdshwprv.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 unità. Questa struttura è identica alla struttura VDS_DRIVE_PROP , ad eccezione del fatto che include il numero di enclosure, il tipo di bus e la velocità di rotazione come membri.

Sintassi

typedef struct _VDS_DRIVE_PROP2 {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  ULONG                ulFlags;
  VDS_DRIVE_STATUS     status;
  VDS_HEALTH           health;
  SHORT                sInternalBusNumber;
  SHORT                sSlotNumber;
  ULONG                ulEnclosureNumber;
  VDS_STORAGE_BUS_TYPE busType;
  ULONG                ulSpindleSpeed;
} VDS_DRIVE_PROP2, *PVDS_DRIVE_PROP2;

Members

id

GUID dell'oggetto unità.

ullSize

Dimensioni dell'unità, in byte.

pwszFriendlyName

Stringa di caratteri wide con terminazione NULL contenente il nome dell'unità.

pwszIdentification

Stringa di caratteri wide con terminazione NULL contenente l'identificatore dell'unità.

ulFlags

Maschera di bit di
VDS_DRIVE_FLAG valori di enumerazione.

status

Una
VDS_DRIVE_STATUS valore di enumerazione che specifica lo stato dell'unità.

health

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

Windows Server 2008, Windows Vista e Windows Server 2003: VDS_H_REPLACED e VDS_H_PENDING_FAILURE non sono supportati.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE (10)

sInternalBusNumber

Numero dell'autobus a cui è connessa l'unità. Questo numero è un valore assegnato dall'implementatore che identifica in modo univoco il bus all'interno del sottosistema. Non è vincolato dal numero di bus contenuti nel sottosistema e non è correlato al valore del membro sNumberOfInternalBuses della struttura VDS_SUB_SYSTEM_PROP .

sSlotNumber

Numero dello slot occupato dall'unità. Questo numero è un valore assegnato dall'implementatore che identifica in modo univoco lo slot all'interno del bus. Non è vincolato dal numero di slot contenuti dal bus e non è correlato al valore del membro sMaxNumberOfSlotsEachBus della struttura VDS_SUB_SYSTEM_PROP .

ulEnclosureNumber

Numero dell'enclosure che contiene l'unità. Un valore di ULONG_MAX indica che questo numero non è definito per l'unità. Poiché alcuni schemi di numerazione enclosure sono in base zero, zero è un valore valido per questo membro. Questo membro corrisponde al parametro ulEnclosureNumber del metodo IVdsSubSystem2::GetDrive2 .

busType

Valore VDS_STORAGE_BUS_TYPE che specifica il tipo di bus dell'unità. Il valore zero indica che il tipo di bus è sconosciuto.

ulSpindleSpeed

Velocità di rotazione dell'unità, in RPM. Il valore predefinito per questo membro è zero. Un valore pari a zero indica che la velocità di rotazione è sconosciuta. Il valore 1 indica che l'unità non dispone di supporti rotanti. Ad esempio, potrebbe trattarsi di un'unità a stato solido.

Commenti

Questa struttura viene utilizzata dal metodo IVdsDrive2::GetProperties2 per restituire le proprietà per un oggetto unità.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	vdshwprv.h

Condividi tramite