estrutura VDS_LUN_INFORMATION (vdslun.h)

Artigo
03/13/2024

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define informações sobre um LUN ou disco. Os aplicativos podem usar essa estrutura para identificar exclusivamente um LUN o tempo todo.

Sintaxe

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;

Membros

m_version

A versão dessa estrutura. O valor atual é a constante VER_VDS_LUN_INFORMATION.

m_DeviceType

O tipo de dispositivo SCSI-2 do LUN.

m_DeviceTypeModifier

O modificador de tipo de dispositivo SCSI-2 do LUN. Para LUNs que não têm nenhum modificador de tipo de dispositivo, o valor é zero.

m_bCommandQueueing

Se TRUE, o LUN dá suporte a vários comandos pendentes; caso contrário, FALSE. A sincronização da fila é responsabilidade do driver de porta.

m_BusType

O tipo de barramento do LUN enumerado por VDS_STORAGE_BUS_TYPE.

m_szVendorId

Ponteiro para o identificador do fornecedor lun; uma cadeia de caracteres legível e terminada em zero. Para dispositivos que não têm identificador de fornecedor, o valor é zero.

m_szProductId

Ponteiro para o identificador de produto LUN, normalmente um número de modelo; uma cadeia de caracteres legível e terminada em zero. Para dispositivos que não têm identificador de produto, o valor é zero.

m_szProductRevision

Ponteiro para a revisão do produto LUN; uma cadeia de caracteres legível e terminada em zero. Para dispositivos que não têm revisão de produto, o valor é zero.

m_szSerialNumber

Ponteiro para o número de série do LUN; uma cadeia de caracteres legível e terminada em zero. Para dispositivos que não têm número de série, o valor é zero.

m_diskSignature

A assinatura do LUN. Para discos que usam a estrutura de particionamento MBR (Registro Mestre de Inicialização), os primeiros 32 bits do GUID compõem a assinatura de disco e os bits restantes são zeros. Para discos que usam a estrutura de particionamento GPT (Tabela de Partição GUID), o GUID consiste no identificador de disco GPT. Se esse valor for zero, o disco não será inicializado ou o provedor de hardware não poderá recuperar a assinatura.

m_deviceIdDescriptor

Matriz que contém o descritor LUN em vários formatos, como "VDSStorageIdTypeFCPHName" e "VDSStorageIdTypeVendorSpecific". Os provedores podem usar "VDSStorageIdTypeVendorSpecific" para armazenar uma cadeia de caracteres de bytes arbitrária da escolha do fornecedor de identificar exclusivamente o LUN. Consulte a estrutura de VDS_STORAGE_DEVICE_ID_DESCRIPTOR e a estrutura de VDS_STORAGE_IDENTIFIER .

m_cInterconnects

O número de portas de interconexão especificadas em m_rgInterconnects.

m_rgInterconnects

Ponteiro para uma matriz das portas de interconexão pelas quais o LUN pode ser acessado. Consulte a estrutura de VDS_INTERCONNECT .

Comentários

A estrutura VDS_LUN_INFORMATION inclui campos das páginas Dados de Consulta SCSI e Dados vitais do produto 0x80 e 0x83. O método GetIdentificationData nas interfaces IVdsLun e IVdsDisk retorna essa estrutura. Ele também é passado como um argumento no método IVdsHwProviderPrivate::QueryIfCreatedLun para determinar se um determinado provedor possui um LUN especificado.

Para obter o objeto LUN, use o método IVdsService::GetObject . Em seguida, você pode usar o método IVdsLun::GetProperties para obter as propriedades do LUN.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	vdslun.h (inclua Vds.h, VdsHwPrv.h para provedores de hardware)