структура STORAGE_ADAPTER_DESCRIPTOR (winioctl.h)

  • Статья

Используется с кодом элемента управления IOCTL_STORAGE_QUERY_PROPERTY для получения данных дескриптора адаптера хранилища для устройства.

Синтаксис

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;

Члены

Version

Содержит размер этой структуры в байтах. Значение этого элемента изменится по мере добавления элементов в структуру.

Size

Указывает общий размер возвращаемых данных в байтах. Сюда могут входить данные, которые соответствуют этой структуре.

MaximumTransferLength

Задает максимальное количество байтов, которое адаптер хранилища может передать за одну операцию.

MaximumPhysicalPages

Указывает максимальное количество неоднородных физических страниц, которыми адаптер хранения может управлять за одну передачу (другими словами, степень поддержки точечной и сборочной).

AlignmentMask

Указывает требования к выравниванию адаптера хранилища для передачи данных. Маска выравнивания указывает на ограничения выравнивания для буферов, необходимых адаптеру хранилища для операций передачи. Допустимые значения маски также ограничены характеристиками диспетчеров памяти в разных версиях Windows.

Значение Значение
0
 Буферы должны быть выровнены по границам BYTE .
1
 Буферы должны быть выровнены по границам WORD .
3
 Буферы должны быть выровнены по DWORD32 границам.
7
 Буферы должны быть выровнены по границам DWORD64 .

AdapterUsesPio

Если этот член имеет значение TRUE, адаптер хранилища использует запрограммированные операции ввода-вывода (PIO) и требует использования виртуальных адресов системного пространства, сопоставленных с физической памятью для буферов данных. Если этот элемент имеет значение FALSE, адаптер хранения не использует piO.

AdapterScansDown

Если этот элемент имеет значение TRUE, адаптер хранилища выполняет сканирование на наличие устройств BIOS, то есть адаптер хранилища начинает сканирование с наибольшим номером устройства, а не с наименьшим. Если этот элемент имеет значение FALSE, адаптер хранилища начинает сканирование с наименьшим номером устройства. Этот член зарезервирован для устаревших драйверов мини-портов.

CommandQueueing

Если этот член имеет значение TRUE, адаптер хранилища поддерживает постановку в очередь с тегами SCSI и (или) внутренние очереди на логическую единицу или эквивалентные SCSI. Если этот член имеет значение FALSE, адаптер хранения не поддерживает ни очереди с тегами SCSI, ни внутренние очереди для каждой логической единицы.

AcceleratedTransfer

Если этот член имеет значение TRUE, адаптер хранилища поддерживает синхронную передачу для ускорения операций ввода-вывода. Если этот член имеет значение FALSE, адаптер хранилища не поддерживает синхронную передачу данных для ускорения операций ввода-вывода.

BusType

Задает значение типа STORAGE_BUS_TYPE , указывающее тип шины, к которой подключено устройство.

BusMajorVersion

Указывает основной номер версии адаптера хранилища , если таковой есть.

BusMinorVersion

Указывает дополнительный номер версии адаптера хранилища , если таковой есть.

SrbType

Указывает тип блока запросов SCSI (SRB), используемый адаптером HBA.

Значение Значение
SRB_TYPE_SCSI_REQUEST_BLOCK
 HBA использует блоки запросов SCSI.
SRB_TYPE_STORAGE_REQUEST_BLOCK
 HBA использует расширенные блоки запросов SCSI.
 

Этот член действителен, начиная с Windows 8.

AddressType

Указывает тип адреса адаптера HBA.

Значение Значение
STORAGE_ADDRESS_TYPE_BTL8
 HBA использует 8-разрядную шину, целевую и LUN-адресацию.
 

Этот член действителен, начиная с Windows 8.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел

Структуры управления дисками

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_ADAPTER_DESCRIPTOR

STORAGE_DESCRIPTOR_HEADER

STORAGE_DEVICE_ID_DESCRIPTOR