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

Статья
02/27/2024

Подпрограмма 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_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

Share via