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

Статья
08/07/2023

Подпрограмма StorPortAllocateRegistryBuffer вызывается драйвером мини-порта для выделения буфера, который можно использовать для чтения и записи данных реестра.

Синтаксис

STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
  [in] PVOID  HwDeviceExtension,
  [in] PULONG Length
);

Параметры

[in] HwDeviceExtension

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

[in] Length

Указатель на значение типа long, указывающее на длину буфера реестра в байтах, необходимую вызывающей стороне. В выходных данных значение Length обновляется с учетом фактического размера выделенного буфера в байтах.

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

StorPortAllocateRegistryBuffer возвращает указатель на буфер реестра, запрошенный вызывающим объектом, или значение NULL , если какая-либо ошибка не позволяет выделить память.

Каждый экземпляр драйвера мини-порта может одновременно выделять только один буфер реестра. Если драйвер мини-порта пытается выделить несколько буферов реестра, выделение завершится ошибкой, и StorPortAllocateRegistryBuffer вернет ЗНАЧЕНИЕ NULL.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	storport.h (включая Storport.h)
Библиотека	Storport.lib

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

StorPortFreeRegistryBuffer

Share via