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

Статья
02/07/2025

Подпрограмма 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 (include Storport.h)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	storPortIrql(storport)

См. также

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

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