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

Статья
02/07/2025

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

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

Синтаксис

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

Параметры

[in] HwDeviceExtension

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

[in] PhysicalAddress

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

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

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

Замечания

ScsiPortGetVirtualAddress использует SCSI_PHYSICAL_ADDRESS для представления физических адресов.

typedef PHYSICAL_ADDRESS SCSI_PHYSICAL_ADDRESS, *PSCSI_PHYSICAL_ADDRESS;

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	srb.h (include Miniport.h, Scsi.h)
библиотеки	Scsiport.lib

См. также

ScsiPortGetPhysicalAddress

ScsiPortGetUncachedExtension

Поделиться через