structure VDS_DRIVE_PROP2 (vds.h)

Article
03/03/2024

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]

Définit les propriétés d’un objet de lecteur. Cette structure est identique à la structure VDS_DRIVE_PROP , sauf qu’elle inclut le numéro de boîtier, le type de bus et la vitesse de broche comme membres.

Syntaxe

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;

Membres

id

GUID de l’objet de lecteur.

ullSize

Taille du lecteur, en octets.

pwszFriendlyName

Chaîne de caractères larges terminée par NULL qui contient le nom du lecteur.

pwszIdentification

Chaîne de caractères larges terminée par null qui contient l’identificateur de lecteur.

ulFlags

Masque de bits de
VDS_DRIVE_FLAG valeurs d’énumération .

status

A
VDS_DRIVE_STATUS valeur d’énumération qui spécifie le status du lecteur.

health

Valeur d’énumération VDS_HEALTH qui spécifie le status d’intégrité du lecteur. Voici les valeurs valides pour ce membre.

Windows Server 2008, Windows Vista et Windows Server 2003 : VDS_H_REPLACED et VDS_H_PENDING_FAILURE ne sont pas pris en charge.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE (10)

sInternalBusNumber

Numéro du bus auquel le lecteur est connecté. Ce nombre est une valeur affectée par l’implémenteur qui identifie de façon unique le bus dans le sous-système. Il n’est pas limité par le nombre de bus que contient le sous-système et n’est pas lié à la valeur du membre sNumberOfInternalBuses de la structure VDS_SUB_SYSTEM_PROP .

sSlotNumber

Numéro de l’emplacement occupé par le lecteur. Ce nombre est une valeur affectée par l’implémenteur qui identifie de manière unique l’emplacement dans le bus. Il n’est pas limité par le nombre d’emplacements que contient le bus et n’est pas lié à la valeur du membre sMaxNumberOfSlotsEachBus de la structure VDS_SUB_SYSTEM_PROP .

ulEnclosureNumber

Numéro du boîtier qui contient le lecteur. La valeur ULONG_MAX indique que ce nombre n’est pas défini pour le lecteur. Étant donné que certains schémas de numérotation de boîtier sont de base zéro, zéro est une valeur valide pour ce membre. Ce membre correspond au paramètre ulEnclosureNumber de la méthode IVdsSubSystem2 ::GetDrive2 .

busType

Valeur VDS_STORAGE_BUS_TYPE qui spécifie le type de bus du lecteur. La valeur zéro signifie que le type de bus est inconnu.

ulSpindleSpeed

Vitesse de rotation du lecteur, en RPM. La valeur par défaut de ce membre est zéro. La valeur zéro signifie que la vitesse de la broche est inconnue. La valeur 1 signifie que le lecteur n’a pas de média pivotant. (Par exemple, il peut s’agir d’un disque SSD.)

Remarques

Cette structure est utilisée par la méthode IVdsDrive2 ::GetProperties2 pour retourner les propriétés d’un objet de lecteur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	vds.h

Partager via