StorPortAllocateRegistryBuffer 函数 (storport.h)
微型端口驱动程序调用 StorPortAllocateRegistryBuffer 例程来分配可用于读取和写入注册表数据的缓冲区。
语法
STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
[in] PVOID HwDeviceExtension,
[in] PULONG Length
);
参数
[in] HwDeviceExtension
指向硬件设备扩展的指针。 这是端口驱动程序代表微型端口驱动程序分配和初始化的每个 HBA 存储区域。 微型端口驱动程序通常在此扩展中存储特定于 HBA 的信息,例如 HBA 的状态和 HBA 的映射访问范围。 微型端口驱动程序调用 StorPortInitialize后,此区域立即可供微型端口驱动程序使用。 端口驱动程序在删除设备时释放此内存。 在调用此例程时,微型端口驱动程序必须在 IRQL PASSIVE_LEVEL运行。
[in] Length
指向一个长指针,指示调用方所需的注册表缓冲区的长度(以字节为单位)。 在输出中,长度 更新,以反映已分配缓冲区的实际大小(以字节为单位)。
返回值
StorPortAllocateRegistryBuffer 返回指向调用方请求的注册表缓冲区的指针,或者如果某些错误阻止分配内存,则 NULL。
言论
微型端口驱动程序的每个实例化一次只能分配一个注册表缓冲区。 如果微型端口驱动程序尝试分配多个注册表缓冲区,则分配将失败,StorPortAllocateRegistryBuffer 将返回 NULL。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | storport.h (包括 Storport.h) |
库 | Storport.lib |