VDS_LUN_INFORMATION structure (vdslun.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 des informations sur un numéro d’unité logique ou un disque. Les applications peuvent utiliser cette structure pour identifier un numéro d’unité logique de manière unique à tout moment.

Syntaxe

typedef struct _VDS_LUN_INFORMATION {
  ULONG                            m_version;
  BYTE                             m_DeviceType;
  BYTE                             m_DeviceTypeModifier;
  BOOL                             m_bCommandQueueing;
  VDS_STORAGE_BUS_TYPE             m_BusType;
  char                             *m_szVendorId;
  char                             *m_szProductId;
  char                             *m_szProductRevision;
  char                             *m_szSerialNumber;
  GUID                             m_diskSignature;
  VDS_STORAGE_DEVICE_ID_DESCRIPTOR m_deviceIdDescriptor;
  ULONG                            m_cInterconnects;
  VDS_INTERCONNECT                 *m_rgInterconnects;
} VDS_LUN_INFORMATION;

Membres

m_version

Version de cette structure. La valeur actuelle est la constante VER_VDS_LUN_INFORMATION.

m_DeviceType

Type d’appareil SCSI-2 du numéro d’unité logique.

m_DeviceTypeModifier

Modificateur de type d’appareil SCSI-2 du numéro d’unité logique. Pour les LUN qui n’ont pas de modificateur de type d’appareil, la valeur est zéro.

m_bCommandQueueing

Si la valeur est TRUE, le numéro d’unité logique prend en charge plusieurs commandes en attente ; sinon, FALSE. La synchronisation de la file d’attente est de la responsabilité du pilote de port.

m_BusType

Type de bus du numéro d’unité logique énuméré par VDS_STORAGE_BUS_TYPE.

m_szVendorId

Pointeur vers l’identificateur du fournisseur de lun ; chaîne à terminaison zéro, lisible par l’homme. Pour les appareils qui n’ont pas d’identificateur de fournisseur, la valeur est zéro.

m_szProductId

Pointeur vers l’identificateur de produit LUN, généralement un numéro de modèle ; chaîne à terminaison zéro, lisible par l’homme. Pour les appareils qui n’ont pas d’identificateur de produit, la valeur est zéro.

m_szProductRevision

Pointeur vers la révision du produit LUN ; chaîne à terminaison zéro, lisible par l’homme. Pour les appareils qui n’ont pas de révision de produit, la valeur est zéro.

m_szSerialNumber

Pointeur vers le numéro de série lun ; chaîne à terminaison zéro, lisible par l’homme. Pour les appareils qui n’ont pas de numéro de série, la valeur est zéro.

m_diskSignature

Signature du numéro d’unité logique. Pour les disques qui utilisent la structure de partitionnement de l’enregistrement de démarrage principal (MBR), les 32 premiers bits du GUID composent la signature du disque, et les bits restants sont des zéros. Pour les disques qui utilisent la structure de partitionnement GPT (GUID Partition Table), le GUID se compose de l’identificateur de disque GPT. Si cette valeur est égale à zéro, le disque est non initialisé ou le fournisseur de matériel n’a pas pu récupérer la signature.

m_deviceIdDescriptor

Tableau contenant le descripteur LUN dans différents formats, tels que « VDSStorageIdTypeFCPHName » et « VDSStorageIdTypeVendorSpecific ». Les fournisseurs peuvent utiliser « VDSStorageIdTypeVendorSpecific » pour stocker une chaîne d’octets arbitraire du choix du fournisseur d’identifier le numéro d’unité logique de manière unique. Consultez la structure VDS_STORAGE_DEVICE_ID_DESCRIPTOR et la structure VDS_STORAGE_IDENTIFIER .

m_cInterconnects

Nombre de ports d’interconnexion spécifiés dans m_rgInterconnects.

m_rgInterconnects

Pointeur vers un tableau des ports d’interconnexion par lesquels le numéro d’unité logique est accessible. Consultez la structure VDS_INTERCONNECT .

Remarques

La structure VDS_LUN_INFORMATION comprend des champs des pages Données d’enquête SCSI et Données de produit vitales 0x80 et 0x83. La méthode GetIdentificationData sur les interfaces IVdsLun et IVdsDisk retourne cette structure. Il est également passé en tant qu’argument dans la méthode IVdsHwProviderPrivate ::QueryIfCreatedLun pour déterminer si un fournisseur donné possède un numéro d’unité logique spécifié.

Pour obtenir l’objet LUN, utilisez la méthode IVdsService ::GetObject . Vous pouvez ensuite utiliser la méthode IVdsLun ::GetProperties pour obtenir les propriétés du numéro d’unité logique.

Configuration requise

Condition requise	Valeur
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	vdslun.h (inclure Vds.h, VdsHwPrv.h pour les fournisseurs de matériel)