Функция StorPortAllocateRegistryBuffer (storport.h)
Подпрограмма storPortAllocateRegistryBuffer вызывается драйвером минипорта для выделения буфера, который можно использовать для чтения и записи данных реестра.
Синтаксис
STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
[in] PVOID HwDeviceExtension,
[in] PULONG Length
);
Параметры
[in] HwDeviceExtension
Указатель на расширение аппаратного устройства. Это область хранения HBA, которую драйвер портов выделяет и инициализирует от имени мини-порта. Драйверы минипорта обычно хранят сведения, относящиеся к HBA, в этом расширении, например состояние HBA и сопоставленные диапазоны доступа для HBA. Эта область доступна драйверу мини-порта сразу после вызова драйвера мини-порта StorPortInitialize. Драйвер портов освобождает эту память при удалении устройства. Мини-порт должен работать в IRQL PASSIVE_LEVEL при вызове этой процедуры.
[in] Length
Указатель на длину, указывающую на входные данные, длину в байтах буфера реестра, которую требует вызывающий объект. В выходных данных длина обновляется, чтобы отразить фактический размер в байтах выделенного буфера.
Возвращаемое значение
StorPortAllocateRegistryBuffer возвращает указатель на буфер реестра, запрошенный вызывающим объектом, или NULL, если некоторые ошибки препятствуют выделению памяти.
Замечания
Каждое создание экземпляра мини-драйвера может иметь только один буфер реестра, выделенный одновременно. Если мини-драйвер пытается выделить несколько буферов реестра, выделение завершится ошибкой и StorPortAllocateRegistryBuffer вернет NULL.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | storport.h (include Storport.h) |
| библиотеки | Storport.lib |