StorPortRegistryWrite 函数 (storport.h)
微型端口驱动程序调用 StorPortRegistryWrite 例程,将指定缓冲区中包含的注册表数据从 ASCII 转换为 Unicode,然后将数据写入微型端口驱动程序的每 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 | Unicode 以 null 结尾的字符串。 |
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 | 带小端格式的 64 位象限数。 |
[in] Buffer
指向包含要写入的注册表数据的缓冲区的指针。
[in] BufferLength
指定 缓冲区指向的缓冲区的大小。
返回值
StorPortRegistryWrite 如果成功转换和写入注册表数据,则返回 TRUE 的布尔值;否则,此例程返回 FALSE。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | storport.h (包括 Storport.h) |
库 | Storport.lib |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | StorPortIrql(storport) |