StorPortRegistryReadAdapterKey 函数 (storport.h)
StorPortRegistryReadAdapterKey 例程由微型端口驱动程序调用，以读取位于 HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/注册表中的硬件或设备注册表适配器密钥。这些键是从 INF DDInstall.HW 部分中读取的。
语法
ULONG StorPortRegistryReadAdapterKey(
[in] PVOID HwDeviceExtension,
[in, optional] PUCHAR SubKeyName,
[in] PUCHAR ValueName,
[in] ULONG ValueType,
[in, out] PVOID *ValueData,
[in, out] PULONG ValueDataLength
);
参数
[in] HwDeviceExtension
指向硬件设备扩展的指针。 这是端口驱动程序代表微型端口驱动程序分配和初始化的每个 HBA 存储区域。 微型端口驱动程序通常在此扩展中存储特定于 HBA 的信息，例如 HBA 的状态和 HBA 的映射访问范围。 在微型端口驱动程序调用 StorPortInitialize 后，微型端口驱动程序立即可以使用此区域。 端口驱动程序在删除设备时释放此内存。 微型端口驱动程序在调用此例程时，必须在 IRQL PASSIVE_LEVEL 运行。
[in, optional] SubKeyName
微型端口子项。
[in] ValueName
键下的“值”的名称。
[in] ValueType
以下注册表数据类型之一。
| 类型 | 含义 |
|---|---|
| REG_SZ | 以 null 结尾的 Unicode 字符串。 |
| REG_EXPAND_SZ | 具有环境变量引用的 Unicode null 结尾字符串。 |
| REG_BINARY | 二进制数据。 |
| REG_DWORD | 32 位双字。 |
| REG_DWORD_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 | 具有小 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 |