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

Статья
08/07/2023

Подпрограмма StorPortValidateRange определяет, используется ли указанный диапазон адресов ввода-вывода другим адаптером. Эта подпрограмма устарела в операционных системах Windows NT 4.0 и более поздних версий.

Синтаксис

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

Параметры

[in] HwDeviceExtension

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

[in] BusType

Содержит значение типа STORAGE_BUS_TYPE , указывающее тип шины.

SystemIoBusNumber

Содержит целое число, определяющее системную шину.

[in] IoAddress

Содержит начальный адрес диапазона адресов для проверки.

[in] NumberOfBytes

Содержит длину в байтах диапазона адресов для проверки.

[in] InIoSpace

При значении TRUE указывает, что диапазон адресов находится в пространстве ввода-вывода. Если значение FALSE, адрес находится в пространстве памяти.

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

StorPortValidateRange возвращает значение TRUE , если указанный диапазон адресов не задан другим драйвером. Эта подпрограмма возвращает значение FALSE , если другой драйвер утверждал диапазон адресов.

Драйверы miniport получают допустимые диапазоны операций ввода-вывода в элементе AccessRangesструктуры PORT_CONFIGURATION_INFORMATION , когда драйвер Storport вызывает подпрограмму обратного вызова HwStorFindAdapter miniport.

StorPortValidateRange использует STOR_PHYSICAL_ADDRESS для представления адресов относительно шины.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

Тип STOR_PHYSICAL_ADDRESS — это независимый от операционной системы тип данных, который драйверы мини-порта Storport используют для представления физических адресов или адресов относительно шины.

Требования

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

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

ScsiPortValidateRange

Share via