structure VDS_DISK_PROP (vds.h)

Article
03/08/2023

[À 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 disque.

Syntaxe

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;

Membres

id

GUID de l’objet disque.

status

Disponibilité d’un disque physique énuméré par VDS_DISK_STATUS. Si le service VDS ne peut pas ouvrir un handle sur le disque, il définit ce membre sur VDS_DS_UNKNOWN.

Note Ce membre peut être VDS_DS_ONLINE, même si l’état du pack conteneur est VDS_PS_OFFLINE.

ReserveMode

Ce membre est réservé pour un usage ultérieur.

health

Valeur d’énumération VDS_HEALTH qui spécifie l’état d’intégrité du disque. Voici les valeurs valides pour ce membre.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

Type d’appareil défini dans Winioctl.h, qui inclut notamment les types suivants :

dwMediaType

Type de média énuméré par STORAGE_MEDIA_TYPE. Les disques de base et dynamiques sont mappés à l’énumérateur FixedMedia . Pour plus d’informations, consultez STORAGE_MEDIA_TYPE.

ullSize

Taille du disque en octets. Pour déterminer la taille maximale du volume d’un disque, appelez IVdsDisk3::QueryFreeExtents et ajoutez les tailles de toutes les extensions libres.

ulBytesPerSector

Nombre d’octets dans chaque secteur.

ulSectorsPerTrack

Nombre de secteurs dans chaque piste.

ulTracksPerCylinder

Nombre de pistes dans chaque cylindre.

ulFlags

Masque de bits de VDS_DISK_FLAG valeurs d’énumération qui spécifient différents attributs de disque.

BusType

Types de bus d’entrée/sortie énumérés par VDS_STORAGE_BUS_TYPE.

PartitionStyle

Valeur d’énumération VDS_PARTITION_STYLE qui spécifie le type de partition. Ce membre est le discriminant du syndicat.

dwSignature

Utilisé si PartitionStyle est VDS_PST_MBR (1). Signature de la partition MBR. Il n’est pas garanti que cette valeur soit unique.

DiskGuid

Utilisé si PartitionStyle est VDS_PST_GPT (2). GUID du disque. En outre, chaque partition GPT a son propre GUID. (Voir VDS_PARTITION_INFO_GPT.)

pwszDiskAddress

Adresse d’un disque de type SCSI au formatNNN NNNcibleNNN Chemin NNN cible NNNlun, où NNN est un ou plusieurs chiffres.

Les disques SCSI, les disques IDE et les disques Fibre Channel peuvent avoir une telle adresse. Les disques USB et 1394 ont des formats d’adresse différents et ne sont pas stockés.

Ce membre est facultatif et peut être NULL si aucune valeur n’est disponible. S’il n’est pas NULL, sa longueur doit être supérieure ou égale à 22 WCHAR et inférieure ou égale à 64 WCHAR, y compris le terminateur NULL requis. Les applications qui reçoivent la structure VDS_DISK_PROP en appelant IVdsDisk::GetProperties doivent vérifier si ce membre a la valeur NULL.

pwszName

Nom utilisé pour ouvrir un handle à un objet créé à l’aide de la fonction CreateFile . Par exemple : \\?\PhysicalDrive2

pwszFriendlyName

Nom retourné par le gestionnaire de Plug-and-Play. Ce nom est conservé dans le Registre Windows par le gestionnaire Plug-and-Play, par exemple : « PÉRIPHÉRIQUE de disque SCSI ST34573N ».

pwszAdaptorName

Nom de l’adaptateur auquel ce disque est attaché. Le Plug-and-Play Manager retourne le nom, qui est conservé dans le Registre Windows, par exemple : « Adaptec AHA-2940U2W - Ultra2 SCSI ».

pwszDevicePath

Chaîne retournée par le gestionnaire de Plug-and-Play. Le gestionnaire de Plug-and-Play utilise le chemin d’accès de l’appareil pour identifier de manière unique un appareil sur un ordinateur. Pour plus d’informations, consultez SP_DEVICE_INTERFACE_DETAIL_DATA_W.

Remarques

La méthode IVdsDisk::GetProperties retourne la valeur de cette structure pour signaler les propriétés d’un objet de disque.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	vds.h