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


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

Подпрограмма 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.

Комментарии

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

typedef PHYSICAL_ADDRESS SCSI_PHYSICAL_ADDRESS, *PSCSI_PHYSICAL_ADDRESS;

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

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

Требования

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

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

ScsiPortGetPhysicalAddress

ScsiPortGetUncachedExtension