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

指向 long 的指针，指示输入时，调用方所需的注册表缓冲区的长度（以字节为单位）。 输出时， Length 将更新，以反映已分配的缓冲区的实际大小（以字节为单位）。

返回值

StorPortAllocateRegistryBuffer 返回指向调用方请求的注册表缓冲区的指针;如果某个错误阻止分配内存，则返回 NULL 。

注解

微型端口驱动程序的每个实例化一次只能分配一个注册表缓冲区。 如果微型端口驱动程序尝试分配多个注册表缓冲区，分配将失败， StorPortAllocateRegistryBuffer 将返回 NULL。

要求

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

另请参阅

StorPortFreeRegistryBuffer