Compartir a través de

estructura STORAGE_ADAPTER_DESCRIPTOR (winioctl.h)

  • Artículo

Se usa con el código de control IOCTL_STORAGE_QUERY_PROPERTY para recuperar los datos del descriptor del adaptador de almacenamiento para un dispositivo.

Sintaxis

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;

Miembros

Version

Contiene el tamaño de esta estructura, en bytes. El valor de este miembro cambiará a medida que se agreguen miembros a la estructura.

Size

Especifica el tamaño total de los datos devueltos, en bytes. Esto puede incluir datos que siguen a esta estructura.

MaximumTransferLength

Especifica el número máximo de bytes que el adaptador de almacenamiento puede transferir en una sola operación.

MaximumPhysicalPages

Especifica el número máximo de páginas físicas discontinuas que el adaptador de almacenamiento puede administrar en una sola transferencia (es decir, la extensión de su compatibilidad de dispersión/recopilación).

AlignmentMask

Especifica los requisitos de alineación del adaptador de almacenamiento para las transferencias. La máscara de alineación indica las restricciones de alineación de los búferes requeridos por el adaptador de almacenamiento para las operaciones de transferencia. Los valores de máscara válidos también están restringidos por características de los administradores de memoria en diferentes versiones de Windows.

Valor Significado
0
 Los búferes deben alinearse en los límites BYTE .
1
 Los búferes deben alinearse en los límites de WORD .
3
 Los búferes deben alinearse en DWORD32 límites.
7
 Los búferes deben alinearse en DWORD64 límites.

AdapterUsesPio

Si este miembro es TRUE, el adaptador de almacenamiento usa E/S programado (PIO) y requiere el uso de direcciones virtuales de espacio del sistema asignadas a la memoria física para los búferes de datos. Cuando este miembro es FALSE, el adaptador de almacenamiento no usa PIO.

AdapterScansDown

Si este miembro es TRUE, el adaptador de almacenamiento examina los dispositivos BIOS, es decir, el adaptador de almacenamiento comienza a examinar con el número de dispositivo más alto en lugar del más bajo. Cuando este miembro es FALSE, el adaptador de almacenamiento comienza a examinar con el número de dispositivo más bajo. Este miembro está reservado para controladores de minipuerto heredados.

CommandQueueing

Si este miembro es TRUE, el adaptador de almacenamiento admite colas internas etiquetadas SCSI o por unidad lógica, o el equivalente que no es SCSI. Cuando este miembro es FALSE, el adaptador de almacenamiento no admite colas internas etiquetadas con SCSI ni colas internas por unidad lógica.

AcceleratedTransfer

Si este miembro es TRUE, el adaptador de almacenamiento admite transferencias sincrónicas como una forma de acelerar la E/S. Cuando este miembro es FALSE, el adaptador de almacenamiento no admite transferencias sincrónicas como una forma de acelerar la E/S.

BusType

Especifica un valor de tipo STORAGE_BUS_TYPE que indica el tipo del bus al que está conectado el dispositivo.

BusMajorVersion

Especifica el número de versión principal, si existe, del adaptador de almacenamiento.

BusMinorVersion

Especifica el número de versión secundaria, si existe, del adaptador de almacenamiento.

SrbType

Especifica el tipo de bloque de solicitud SCSI (SRB) usado por el HBA.

Valor Significado
SRB_TYPE_SCSI_REQUEST_BLOCK
 El HBA usa bloques de solicitudes SCSI.
SRB_TYPE_STORAGE_REQUEST_BLOCK
 El HBA usa bloques de solicitudes SCSI extendidas.
 

Este miembro es válido a partir de Windows 8.

AddressType

Especifica el tipo de dirección del HBA.

Valor Significado
STORAGE_ADDRESS_TYPE_BTL8
 El HBA usa direccionamiento de bus, destino y LUN de 8 bits.
 

Este miembro es válido a partir de Windows 8.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluya Windows.h)

Consulte también

Estructuras de administración de discos

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_ADAPTER_DESCRIPTOR

STORAGE_DESCRIPTOR_HEADER

STORAGE_DEVICE_ID_DESCRIPTOR