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


Функция 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)

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

StorPortInitialize