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

Функция StorPortGetSystemAddress (storport.h)

  • Статья

Подпрограмма StorPortGetSystemAddress возвращает виртуальный адрес в системном пространстве для буфера данных указанного блока запросов SCSI (SRB).

Синтаксис

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

[in] Srb

Указатель на структуру SCSI_REQUEST_BLOCK .

[out] SystemAddress

Указатель для получения виртуального адреса буфера данных.

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

StorPortGetSystemAddress возвращает один из следующих кодов состояния:

Код возврата Описание
STOR_STATUS_NOT_IMPLEMENTED
 Эта функция не реализована в активной операционной системе.
STOR_STATUS_SUCCESS
 Указывает, что системный адрес был успешно получен.
STOR_STATUS_INVALID_PARAMETER
 Этот код состояния вызван одним из следующих условий:

SRB не имеет связанного буфера данных.

Указатель для получения виртуального адреса имеет значение NULL.
STOR_STATUS_INVALID_IRQL
 Вызов был выполнен в недопустимом IRQL.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Не удалось сопоставить буфер данных с системным пространством.

Комментарии

Начиная с Windows 8, параметр Srb может указывать на SCSI_REQUEST_BLOCK или STORAGE_REQUEST_BLOCK. Если идентификатор функции в поле ФункцияSrbSRB_FUNCTION_STORAGE_REQUEST_BLOCK, SRB является STORAGE_REQUEST_BLOCK структурой запроса.

Требования

Требование Значение
Минимальная версия клиента Эта подпрограмма доступна начиная с Windows Server 2003 с пакетом обновления 2 (SP2).
Целевая платформа Универсальное
Верхняя часть storport.h (включая Storport.h)
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI StorPortIrql(storport)

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

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK