StorPortRegistryWriteAdapterKey 函数 (storport.h)

  • 项目

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 的状态和 HBA 的映射访问范围。 此区域在微型端口驱动程序调用 StorPortInitialize 后立即可供微型端口驱动程序使用。 端口驱动程序在移除设备时释放此内存。 微型端口驱动程序在调用此例程时，必须在 IRQL PASSIVE_LEVEL 运行。

[in, optional] SubKeyName

微型端口子项。

[in] ValueName

键下 Value 的名称。

[in] ValueType

以下注册表数据类型之一。

类型 含义
REG_SZ 以 null 结尾的 Unicode 字符串。
REG_EXPAND_SZ 具有环境变量引用的以 null 结尾的 Unicode 字符串。
REG_BINARY 二进制数据。
REG_DWORD 32 位双字。
REG_DWORD_LITTLE_ENDIAN 采用 little-endian 格式的 32 位双字。
REG_DWORD_BIG_ENDIAN 具有大尾号格式的 32 位双字。
REG_LINK 指定符号链接的 Unicode 字符串。
REG_MULTI_SZ 多个 Unicode 字符串。
REG_RESOURCE_LIST 资源映射中的资源列表。
REG_FULL_RESOURCE_DESCRIPTOR 硬件说明中的资源列表。
REG_RESOURCE_REQUIREMENTS_LIST 资源要求列表。
REG_QWORD 64 位象限数。
REG_QWORD_LITTLE_ENDIAN 采用 little-endian 格式的 64 位象限数。

[in, out] ValueData

指向包含要读取的注册表数据的数据的指针。 数据从 UNICODE 转换为以 NULL 结尾的 ASCII 字符串。

[in, out] ValueDataLength

指定 ValueData 指向的数据的大小。

返回值

当操作成功时返回STOR_STATUS_SUCCESS，否则返回相应的错误代码。

要求

要求 值
目标平台 通用
标头 storport.h (包括 Storport.h)
Library Storport.lib
IRQL PASSIVE_LEVEL

另请参阅

StorPortInitialize