Функция StorPortRegistryWrite (storport.h)
Подпрограмма StorPortRegistryWrite вызывается драйвером мини-порта для преобразования данных реестра, содержащихся в указанном буфере, из ASCII в Юникод, а затем для записи данных в область хранения драйвера минипорта для каждого HBA.
Синтаксис
STORPORT_API BOOLEAN StorPortRegistryWrite(
[in] PVOID HwDeviceExtension,
[in] PUCHAR ValueName,
[in] ULONG Global,
[in] ULONG Type,
[in] PUCHAR Buffer,
[in] ULONG BufferLength
);
Параметры
[in] HwDeviceExtension
Указатель на расширение аппаратного устройства. Это область хранения HBA, которую драйвер порта выделяет и инициализирует от имени драйвера мини-порта. Драйверы мини-портов обычно хранят сведения, относящиеся к HBA, в этом расширении, такие как состояние HBA и сопоставленные диапазоны доступа для HBA. Эта область доступна драйверу мини-порта сразу после того, как драйвер мини-порта вызывает StorPortInitialize. Драйвер порта освобождает эту память при удалении устройства. Драйвер мини-порта должен работать на PASSIVE_LEVEL IRQL при вызове этой подпрограммы.
[in] ValueName
Указатель на строку, указывающую имя значения.
[in] Global
Указывает, должна ли операция быть специфичной для адаптера или относиться ко всем адаптерам.
[in] Type
Один из следующих типов данных реестра.
| Тип | Значение |
|---|---|
| REG_SZ | Строка в Юникоде, заканчивающаяся null. |
| REG_EXPAND_SZ | Строка в Юникоде со ссылками на переменные среды, заканчивающаяся null. |
| REG_BINARY | Двоичные данные. |
| REG_DWORD | 32-разрядное двойное слово. |
| REG_DWORD_LITTLE_ENDIAN | 32-разрядное двойное слово с маленьким эндианским форматом. |
| REG_DWORD_BIG_ENDIAN | 32-разрядное двойное слово в формате big-endian. |
| REG_LINK | Строка Юникода, задающая символьную ссылку. |
| REG_MULTI_SZ | Несколько строк Юникода. |
| REG_RESOURCE_LIST | Список ресурсов на карте ресурсов. |
| REG_FULL_RESOURCE_DESCRIPTOR | Список ресурсов в описании оборудования. |
| REG_RESOURCE_REQUIREMENTS_LIST | Список обязательных ресурсов. |
| REG_QWORD | 64-разрядный номер квадлета. |
| REG_QWORD_LITTLE_ENDIAN | 64-разрядный номер квадлета с маленьким эндианским форматом. |
[in] Buffer
Указатель на буфер, содержащий записываемые данные реестра.
[in] BufferLength
Указывает размер буфера, на который указывает буфер.
Возвращаемое значение
StorPortRegistryWrite возвращает логическое значение TRUE , если данные реестра были успешно преобразованы и записаны; В противном случае эта подпрограмма возвращает значение FALSE.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | storport.h (включая Storport.h) |
| Библиотека | Storport.lib |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | StorPortIrql(storport) |