Функция StorPortAllocateRegistryBuffer (storport.h)
Подпрограмма 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 |