StorPortPoFxActivateComponent 函数 (storport.h)

StorPortPoFxActivateComponent 例程递增存储设备的指定组件上的激活引用计数。

语法

ULONG StorPortPoFxActivateComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

参数

[in] HwDeviceExtension

指向主机总线适配器的硬件设备扩展的指针 (HBA) 。

[in, optional] Address

存储设备单元的地址。 激活存储适配器组件时,此参数为 NULL

[in, optional] Srb

触发组件激活的 SRB。 如果微型端口为未通过 Storport 发送的请求激活设备组件,则此参数为 NULL

[in] Component

标识组件的索引。 此参数是微型端口驱动程序通过调用 StorPortInitializePoFxPower 为设备注册的 STOR_POFX_DEVICE 结构中的 Components 数组的索引。 如果 Components 数组包含 N 个元素,则组件索引的范围为 0 到 N–1。

[in] Flags

未使用。 设置为 0。

返回值

StorPortPoFxActivateComponent 例程返回以下状态代码之一:

返回代码 说明
STOR_STATUS_SUCCESS
存储设备激活引用已成功递增,组件处于活动状态。
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtensionDevice 为 NULL。

-或-

地址 指向无效的单位地址结构。

-或-

找不到 地址 指定的存储设备。

-或-

存储设备未注册到电源管理框架 (PoFx) 。

-或-

Srb 指向的 SRB 不是从 Storport 发送的。

-或-

Flags 参数为非零。

STOR_STATUS_INVALID_DEVICE_REQUEST
适配器或单元不支持 PoFx。
STOR_STATUS_INVALID_IRQL
当前 IRQL > DISPATCH_LEVEL。
STOR_STATUS_BUSY
存储设备激活引用已成功递增,但组件仍处于空闲状态

注解

目前,适配器设备和单元设备的最大组件计数为 1。 组件中的索引必须始终设置为 0。

每次调用 StorPortPoFxActivateComponent 必须与后续对 StorPortPoFxIdleComponent 的调用匹配。

要求

要求
最低受支持的客户端 从 Windows 8 开始可用。
目标平台 通用
标头 storport.h
Library Storport.lib
IRQL IRQL <= DISPATCH_LEVEL

另请参阅

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent