Поделиться через


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

Подпрограмма StorPortGetSystemPortNumber извлекает назначенный системой номер порта для адаптера хранилища.

Синтаксис

ULONG StorPortGetSystemPortNumber(
  [in]      PVOID         HwDeviceExtension,
  [in, out] PSTOR_ADDRESS Address
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in, out] Address

Указатель на структуру адреса хранилища в формате STOR_ADDR_BTL8. При возврате элемент Port этой структуры будет содержать значение порта, назначенное адаптеру.

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

StorPortGetSystemPortNumber возвращает один из следующих кодов состояния:

Код возврата Описание
STOR_STATUS_INVALID_DEVICE_STATE
Значение номера порта еще не назначено адаптеру хранилища.
STOR_STATUS_SUCCESS
Указывает, что номер порта адаптера хранения успешно возвращен.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension имеет значение NULL.

-или-

Элемент Typeэлемента Address не является STOR_ADDRESS_TYPE_BTL8.

Комментарии

Структура адресов, на которую указывает адрес, выделяется и форматируется как STOR_ADDR_BTL8. Элементу Typeэлемента Address должно быть присвоено значение STOR_ADDRESS_TYPE_BTL8, а параметру Адрес элемента Length должно быть больше или равно STOR_ADDR_BTL8_ADDRESS_LENGTH.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть storport.h

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

STOR_ADDRESS

STOR_ADDR_BTL8