estrutura STORAGE_ADAPTER_DESCRIPTOR (winioctl.h)

  • Artigo

Usado com o código de controle IOCTL_STORAGE_QUERY_PROPERTY para recuperar os dados do descritor do adaptador de armazenamento para um dispositivo.

Sintaxe

typedef struct _STORAGE_ADAPTER_DESCRIPTOR {
  DWORD   Version;
  DWORD   Size;
  DWORD   MaximumTransferLength;
  DWORD   MaximumPhysicalPages;
  DWORD   AlignmentMask;
  BOOLEAN AdapterUsesPio;
  BOOLEAN AdapterScansDown;
  BOOLEAN CommandQueueing;
  BOOLEAN AcceleratedTransfer;
#if ...
  BOOLEAN BusType;
#else
  BYTE    BusType;
#endif
  WORD    BusMajorVersion;
  WORD    BusMinorVersion;
  BYTE    SrbType;
  BYTE    AddressType;
} STORAGE_ADAPTER_DESCRIPTOR, *PSTORAGE_ADAPTER_DESCRIPTOR;

Membros

Version

Contém o tamanho dessa estrutura, em bytes. O valor desse membro será alterado à medida que os membros forem adicionados à estrutura .

Size

Especifica o tamanho total dos dados retornados, em bytes. Isso pode incluir dados que seguem essa estrutura.

MaximumTransferLength

Especifica o número máximo de bytes que o adaptador de armazenamento pode transferir em uma única operação.

MaximumPhysicalPages

Especifica o número máximo de páginas físicas descontinuadas que o adaptador de armazenamento pode gerenciar em uma única transferência (em outras palavras, a extensão de seu suporte de dispersão/coleta).

AlignmentMask

Especifica os requisitos de alinhamento do adaptador de armazenamento para transferências. A máscara de alinhamento indica restrições de alinhamento para buffers exigidos pelo adaptador de armazenamento para operações de transferência. Os valores de máscara válidos também são restritos por características dos gerenciadores de memória em diferentes versões do Windows.

Valor Significado
0
 Os buffers devem ser alinhados nos limites de BYTE .
1
 Os buffers devem ser alinhados nos limites do WORD .
3
 Os buffers devem ser alinhados em limites de DWORD32 .
7
 Os buffers devem ser alinhados em limites de DWORD64 .

AdapterUsesPio

Se esse membro for TRUE, o adaptador de armazenamento usará PIO (E/S) programada e exigirá o uso de endereços virtuais de espaço do sistema mapeados para memória física para buffers de dados. Quando esse membro é FALSE, o adaptador de armazenamento não usa PIO.

AdapterScansDown

Se esse membro for TRUE, o adaptador de armazenamento verificará se há dispositivos BIOS, ou seja, o adaptador de armazenamento começa a verificar com o número de dispositivo mais alto em vez do mais baixo. Quando esse membro é FALSE, o adaptador de armazenamento começa a examinar com o menor número de dispositivo. Esse membro é reservado para drivers de miniporta herdados.

CommandQueueing

Se esse membro for TRUE, o adaptador de armazenamento oferecerá suporte ao enfileiramento marcado por SCSI e/ou filas internas por unidade lógica ou ao equivalente não SCSI. Quando esse membro é FALSE, o adaptador de armazenamento não dá suporte a filas internas marcadas por SCSI nem por unidade lógica.

AcceleratedTransfer

Se esse membro for TRUE, o adaptador de armazenamento oferecerá suporte a transferências síncronas como uma forma de acelerar a E/S. Quando esse membro é FALSE, o adaptador de armazenamento não dá suporte a transferências síncronas como uma forma de acelerar a E/S.

BusType

Especifica um valor do tipo STORAGE_BUS_TYPE que indica o tipo do barramento ao qual o dispositivo está conectado.

BusMajorVersion

Especifica o número de versão principal, se houver, do adaptador de armazenamento.

BusMinorVersion

Especifica o número de versão secundária, se houver, do adaptador de armazenamento.

SrbType

Especifica o tipo de SRB (bloco de solicitação SCSI) usado pelo HBA.

Valor Significado
SRB_TYPE_SCSI_REQUEST_BLOCK
 O HBA usa blocos de solicitação SCSI.
SRB_TYPE_STORAGE_REQUEST_BLOCK
 O HBA usa blocos de solicitação SCSI estendidos.
 

Esse membro é válido começando com Windows 8.

AddressType

Especifica o tipo de endereço do HBA.

Valor Significado
STORAGE_ADDRESS_TYPE_BTL8
 O HBA usa o endereçamento de barramento, destino e LUN de 8 bits.
 

Esse membro é válido começando com Windows 8.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

Estruturas do gerenciamento de disco

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_ADAPTER_DESCRIPTOR

STORAGE_DESCRIPTOR_HEADER

STORAGE_DEVICE_ID_DESCRIPTOR