Функция ScsiPortGetVirtualAddress (srb.h)

Статья
08/07/2023

Подпрограмма ScsiPortGetVirtualAddress возвращает виртуальный адрес, связанный с физическим адресом, если физический адрес был получен путем вызова ScsiPortGetPhysicalAddress.

Примечание В будущем модели драйвера портов SCSI и драйвера для минипорта SCSI могут быть изменены или недоступны. Вместо этого рекомендуется использовать модели драйверов Storport и драйверов для мини-портов Storport .

Синтаксис

SCSIPORT_API PVOID ScsiPortGetVirtualAddress(
  [in] PVOID                 HwDeviceExtension,
  [in] SCSI_PHYSICAL_ADDRESS PhysicalAddress
);

Параметры

[in] HwDeviceExtension

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

[in] PhysicalAddress

Указывает физический адрес для сопоставления. Это значение должно быть возвращено ScsiPortGetPhysicalAddress и должно быть из расширения некэшированного устройства или расширения SRB.

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

ScsiPortGetVirtualAddress возвращает сопоставленный указатель для заданного входного адреса. Если значение PhysicalAddress недопустимо, возвращается значение NULL.

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	srb.h (включая Miniport.h, Scsi.h)
Библиотека	Scsiport.lib

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

ScsiPortGetPhysicalAddress

ScsiPortGetUncachedExtension

Share via