VDS_LUN_INFORMATION struttura (vdslun.h)

Articolo
03/13/2024

[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 informazioni relative a un LUN o a un disco. Le applicazioni possono usare questa struttura per identificare in modo univoco un LUN in ogni momento.

Sintassi

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;

Members

m_version

Versione di questa struttura. Il valore corrente è la costante VER_VDS_LUN_INFORMATION.

m_DeviceType

Tipo di dispositivo SCSI-2 del LUN.

m_DeviceTypeModifier

Modificatore del tipo di dispositivo SCSI-2 del LUN. Per i LUN che non hanno alcun modificatore del tipo di dispositivo, il valore è zero.

m_bCommandQueueing

Se TRUE, il LUN supporta più comandi in sospeso; in caso contrario, FALSE. La sincronizzazione della coda è la responsabilità del driver della porta.

m_BusType

Tipo di bus del LUN enumerato da VDS_STORAGE_BUS_TYPE.

m_szVendorId

Puntatore all'identificatore del fornitore LUN; stringa con terminazione zero, leggibile dall'utente. Per i dispositivi senza identificatore del fornitore, il valore è zero.

m_szProductId

Puntatore all'identificatore del prodotto LUN, in genere un numero di modello; stringa con terminazione zero, leggibile dall'utente. Per i dispositivi senza identificatore del prodotto, il valore è zero.

m_szProductRevision

Puntatore alla revisione del prodotto LUN; stringa con terminazione zero, leggibile dall'utente. Per i dispositivi che non hanno revisione del prodotto, il valore è zero.

m_szSerialNumber

Puntatore al numero di serie LUN; stringa con terminazione zero, leggibile dall'utente. Per i dispositivi senza numero di serie, il valore è zero.

m_diskSignature

Firma del LUN. Per i dischi che usano la struttura di partizionamento MBR (Master Boot Record), i primi 32 bit del GUID comprendono la firma del disco e i bit rimanenti sono zero. Per i dischi che usano la struttura di partizionamento GPT (GUID Partition Table), il GUID è costituito dall'identificatore del disco GPT. Se questo valore è zero, il disco non è inizializzato o il provider hardware non è riuscito a recuperare la firma.

m_deviceIdDescriptor

Matrice contenente il descrittore LUN in vari formati, ad esempio "VDSStorageIdTypeFCPHName" e "VDSStorageIdTypeVendorSpecific". I provider possono usare "VDSStorageIdTypeVendorSpecific" per archiviare una stringa di byte arbitraria della scelta del fornitore di identificare in modo univoco il LUN. Vedere la struttura VDS_STORAGE_DEVICE_ID_DESCRIPTOR e la struttura VDS_STORAGE_IDENTIFIER .

m_cInterconnects

Numero di porte di interconnessione specificate in m_rgInterconnects.

m_rgInterconnects

Puntatore a una matrice delle porte di interconnessione a cui è possibile accedere al LUN. Vedere la struttura VDS_INTERCONNECT .

Commenti

La struttura VDS_LUN_INFORMATION include campi dalle pagine Dati richiesta SCSI e Dati di prodotto vitale 0x80 e 0x83. Il metodo GetIdentificationData nelle interfacce IVdsLun e IVdsDisk restituisce questa struttura. Viene inoltre passato come argomento nel metodo IVdsHwProviderPrivate::QueryIfCreatedLun per determinare se un determinato provider possiede un LUN specificato.

Per ottenere l'oggetto LUN, usare il metodo IVdsService::GetObject . È quindi possibile usare il metodo IVdsLun::GetProperties per ottenere le proprietà LUN.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	vdslun.h (includere Vds.h, VdsHwPrv.h per provider hardware)