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

Статья
08/07/2023

Подпрограмма StorPortRegistryReadAdapterKey вызывается драйвером мини-порта для чтения ключей адаптера реестра оборудования или устройств, расположенных в реестре по адресу HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/... эти ключи считываются из раздела INF DDInstall.HW.

Синтаксис

ULONG StorPortRegistryWriteAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  ValueData,
  [in, out]      ULONG  ValueDataLength
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства. Это область хранения HBA, которую драйвер порта выделяет и инициализирует от имени драйвера мини-порта. Драйверы мини-портов обычно хранят сведения, относящиеся к HBA, в этом расширении, такие как состояние адаптера безопасности и сопоставленные диапазоны доступа для HBA. Эта область доступна драйверу мини-порта сразу после вызова драйвера минипорта StorPortInitialize. Драйвер порта освобождает эту память при удалении устройства. Драйвер мини-порта должен работать на PASSIVE_LEVEL IRQL при вызове этой подпрограммы.

[in, optional] SubKeyName

Подраздел miniport.

[in] ValueName

Имя значения под ключом.

[in] ValueType

Один из следующих типов данных реестра.

Тип	Значение
REG_SZ	Строка в Юникоде, заканчивающаяся нулевым значением.
REG_EXPAND_SZ	Строка в Юникоде, заканчивающаяся нулевым значением, со ссылками на переменные среды.
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, out] ValueData

Указатель на данные, содержащие данные реестра для чтения. Данные преобразуются из ЮНИКОДа в строку ASCII, завершаемую NULL.

[in, out] ValueDataLength

Указывает размер данных, на которые указывает ValueData.

Возвращаемое значение

Возвращает STOR_STATUS_SUCCESS при успешном выполнении операции, в противном случае — соответствующий код ошибки.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	storport.h (включая Storport.h)
Библиотека	Storport.lib
IRQL	PASSIVE_LEVEL

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

StorPortInitialize

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