estructura VDS_LUN_INFORMATION (vdslun.h)

Artículo
03/03/2024

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Define información sobre un LUN o un disco. Las aplicaciones pueden usar esta estructura para identificar de forma única un LUN en todo momento.

Sintaxis

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;

Miembros

m_version

Versión de esta estructura. El valor actual es la constante VER_VDS_LUN_INFORMATION.

m_DeviceType

Tipo de dispositivo SCSI-2 del LUN.

m_DeviceTypeModifier

Modificador de tipo de dispositivo SCSI-2 del LUN. Para los LUN que no tienen ningún modificador de tipo de dispositivo, el valor es cero.

m_bCommandQueueing

Si es TRUE, el LUN admite varios comandos pendientes; de lo contrario, FALSE. La sincronización de la cola es responsabilidad del controlador de puerto.

m_BusType

Tipo de bus del LUN enumerado por VDS_STORAGE_BUS_TYPE.

m_szVendorId

Puntero al identificador del proveedor de LUN; una cadena legible y terminada en cero. En el caso de los dispositivos que no tienen ningún identificador de proveedor, el valor es cero.

m_szProductId

Puntero al identificador del producto LUN, normalmente un número de modelo; una cadena legible y terminada en cero. En el caso de los dispositivos que no tienen ningún identificador de producto, el valor es cero.

m_szProductRevision

Puntero a la revisión del producto LUN; una cadena legible y terminada en cero. En el caso de los dispositivos que no tienen ninguna revisión del producto, el valor es cero.

m_szSerialNumber

Puntero al número de serie lun; una cadena legible y terminada en cero. En el caso de los dispositivos que no tienen ningún número de serie, el valor es cero.

m_diskSignature

Firma del LUN. En el caso de los discos que usan la estructura de particiones registro de arranque maestro (MBR), los primeros 32 bits del GUID componen la firma del disco y los bits restantes son ceros. En el caso de los discos que usan la estructura de creación de particiones de la tabla de particiones GUID (GPT), el GUID consta del identificador de disco GPT. Si este valor es cero, el disco no está inicializado o el proveedor de hardware no pudo recuperar la firma.

m_deviceIdDescriptor

Matriz que contiene el descriptor LUN en varios formatos, como "VDSStorageIdTypeFCPHName" y "VDSStorageIdTypeVendorSpecific". Los proveedores pueden usar "VDSStorageIdTypeVendorSpecific" para almacenar una cadena de bytes arbitraria de la elección del proveedor para identificar de forma única el LUN. Consulte la estructura de VDS_STORAGE_DEVICE_ID_DESCRIPTOR y la estructura de VDS_STORAGE_IDENTIFIER .

m_cInterconnects

Número de puertos de interconexión especificados en m_rgInterconnects.

m_rgInterconnects

Puntero a una matriz de los puertos de interconexión a los que se puede acceder al LUN. Consulte la estructura de VDS_INTERCONNECT .

Comentarios

La estructura de VDS_LUN_INFORMATION incluye campos de las páginas datos de consulta SCSI y datos de productos vitales 0x80 y 0x83. El método GetIdentificationData en las interfaces IVdsLun e IVdsDisk devuelven esta estructura. También se pasa como argumento en el método IVdsHwProviderPrivate::QueryIfCreatedLun para determinar si un proveedor determinado posee un LUN especificado.

Para obtener el objeto LUN, use el método IVdsService::GetObject . A continuación, puede usar el método IVdsLun::GetProperties para obtener las propiedades de LUN.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	vdslun.h (incluya Vds.h, VdsHwPrv.h para proveedores de hardware)