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

Статья
02/07/2025

Подпрограмма 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. Драйвер портов освобождает эту память при удалении устройства. Мини-порт должен работать в IRQL PASSIVE_LEVEL при вызове этой процедуры.

[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 (include Storport.h)
библиотеки	Storport.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	storPortIrql(storport)

См. также

StorPortInitialize

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