Функция StorPortValidateRange (storport.h)
Подпрограмма 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 , если другой драйвер утверждал диапазон адресов.
Комментарии
Для совместимости с более старыми версиями Windows эта подпрограмма всегда возвращает значение TRUE.
Драйверы 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) |