VDS_LUN_INFORMATION-Struktur (vdslun.h)

Artikel
03/03/2024

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Definiert Informationen zu einer LUN oder einem Datenträger. Anwendungen können diese Struktur verwenden, um eine LUN jederzeit eindeutig zu identifizieren.

Syntax

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;

Member

m_version

Die Version dieser Struktur. Der aktuelle Wert ist die konstante VER_VDS_LUN_INFORMATION.

m_DeviceType

Der SCSI-2-Gerätetyp der LUN.

m_DeviceTypeModifier

Der SCSI-2-Gerätetypmodifizierer der LUN. Für LUNs ohne Gerätetypmodifizierer ist der Wert null.

m_bCommandQueueing

Wenn TRUE, unterstützt die LUN mehrere ausstehende Befehle. andernfalls FALSE. Die Synchronisierung der Warteschlange liegt in der Verantwortung des Porttreibers.

m_BusType

Der Bustyp der LUN, die von VDS_STORAGE_BUS_TYPE aufgelistet wird.

m_szVendorId

Zeiger auf den LUN-Anbieterbezeichner; eine Zeichenfolge, die mit Null beendet wird, die für Menschen lesbar ist. Für Geräte ohne Herstellerbezeichner ist der Wert null.

m_szProductId

Zeiger auf den LUN-Produktbezeichner, in der Regel eine Modellnummer; eine Zeichenfolge, die mit Null beendet wird, die für Menschen lesbar ist. Für Geräte ohne Produktbezeichner ist der Wert null.

m_szProductRevision

Zeiger auf die LUN-Produktrevision; eine Zeichenfolge, die mit Null beendet wird, die für Menschen lesbar ist. Für Geräte ohne Produktrevision ist der Wert null.

m_szSerialNumber

Zeiger auf die LUN-Seriennummer; eine Zeichenfolge, die mit Null beendet wird, die für Menschen lesbar ist. Für Geräte ohne Seriennummer ist der Wert null.

m_diskSignature

Die Signatur der LUN. Für Datenträger, die die MBR-Partitionierungsstruktur (Master Boot Record) verwenden, bestehen die ersten 32 Bits der GUID aus der Datenträgersignatur, und die verbleibenden Bits sind Nullen. Für Datenträger, die die GPT-Partitionierungsstruktur (GUID Partition Table) verwenden, besteht die GUID aus dem GPT-Datenträgerbezeichner. Wenn dieser Wert null ist, wird der Datenträger nicht initialisiert, oder der Hardwareanbieter konnte die Signatur nicht abrufen.

m_deviceIdDescriptor

Array, das den LUN-Deskriptor in verschiedenen Formaten enthält, z. B. "VDSStorageIdTypeFCPHName" und "VDSStorageIdTypeVendorSpecific". Anbieter können "VDSStorageIdTypeVendorSpecific" verwenden, um eine beliebige Bytezeichenfolge des Anbieters zu speichern, der die LUN eindeutig identifiziert. Sehen Sie sich die VDS_STORAGE_DEVICE_ID_DESCRIPTOR-Struktur und die VDS_STORAGE_IDENTIFIER-Struktur an.

m_cInterconnects

Die Anzahl der in m_rgInterconnects angegebenen Verbindungsports.

m_rgInterconnects

Zeiger auf ein Array der Verbindungsports, über die auf die LUN zugegriffen werden kann. Weitere Informationen finden Sie in der VDS_INTERCONNECT-Struktur.

Hinweise

Die VDS_LUN_INFORMATION-Struktur enthält Felder aus den Seiten SCSI-Abfragedaten und Wichtige Produktdaten 0x80 und 0x83. Die GetIdentificationData-Methode für die IVdsLun - und IVdsDisk-Schnittstelle gibt diese Struktur zurück. Es wird auch als Argument in der IVdsHwProviderPrivate::QueryIfCreatedLun-Methode übergeben, um zu bestimmen, ob ein bestimmter Anbieter im Besitz einer angegebenen LUN ist.

Verwenden Sie zum Abrufen des LUN-Objekts die IVdsService::GetObject-Methode . Anschließend können Sie die IVdsLun::GetProperties-Methode verwenden, um die LUN-Eigenschaften abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vdslun.h (einschließlich Vds.h, VdsHwPrv.h für Hardwareanbieter)