Функция StorPortSetAdapterBusType (storport.h)

StorPortSetAdapterBusType используется для настройки типа шины адаптера в зависимости от его текущей конфигурации.

Синтаксис

ULONG StorPortSetAdapterBusType(
  [in] PVOID HwDeviceExtension,
  [in] ULONG BusType
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства. Это область хранения HBA, которую драйвер порта выделяет и инициализирует от имени драйвера мини-порта. Драйверы мини-портов обычно хранят сведения, относящиеся к HBA, в этом расширении, такие как состояние адаптера безопасности и сопоставленные диапазоны доступа для HBA. Эта область доступна для мини-порта сразу после того, как драйвер минипорта вызывает StorPortInitialize. Драйвер порта освобождает эту память при удалении устройства.

[in] BusType

Содержит значение STORAGE_BUS_TYPE , указывающее тип заданных данных конфигурации для конкретной шины.

Возвращаемое значение

Подпрограмма StorPortSetAdapterBusType возвращает один из следующих кодов состояния:

Код возврата Описание
STOR_STATUS_UNSUCCESSFUL Эта подпрограмма была вызвана вне функции HwStorFindAdapter .
STOR_STATUS_SUCCESS Эта процедура успешно завершена.
STOR_STATUS_INVALID_PARAMETER BusType является недопустимым значением.

Комментарии

Задание BusType с помощью этой подпрограммы позволит переопределить глобальное свойство, заданное в мини-порт INF без необходимости повторной установки драйвера. Это полезно для таких сценариев, как поддержка RAID или поддержка нескольких адаптеров с другим типом шины.

Требования

Требование Значение
Минимальная версия клиента Windows 10
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
Библиотека Storport.lib