Функция 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.
Драйверы минипорта предоставляются допустимые диапазоны ввода-вывода в AccessRanges член структуры PORT_CONFIGURATION_INFORMATION, когда драйвер Storport вызывает HwStorFindAdapter минипорта подпрограмме обратного вызова.
StorPortValidateRange использует STOR_PHYSICAL_ADDRESS для представления относительных адресов шины.
typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;
Тип STOR_PHYSICAL_ADDRESS — это независимый от операционной системы тип данных, используемый драйверами минипорта Storport для представления физических адресов или относительного адреса шины.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | storport.h (include Storport.h) |
| библиотеки | Storport.lib |
| правил соответствия DDI | StorPortDeprecated(storport) |