Función StorPortPoFxActivateComponent (storport.h)

La rutina StorPortPoFxActivateComponent incrementa el recuento de referencias de activación en el componente especificado de un dispositivo de almacenamiento.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in, optional] Address

Dirección de una unidad de dispositivo de almacenamiento. Este parámetro es NULL al activar un componente de adaptador de almacenamiento.

[in, optional] Srb

SRB que desencadena la activación del componente. Este parámetro es NULL si el miniport está activando un componente de dispositivo para una solicitud que no se envía a través de Storport.

[in] Component

Índice que identifica el componente. Este parámetro es un índice en la matriz Components de la estructura STOR_POFX_DEVICE que el controlador de miniporte registró para el dispositivo con una llamada a StorPortInitializePoFxPower. Si la matriz Components contiene N elementos, los índices de componente oscilan entre 0 y N-1.

[in] Flags

No se utiliza. Establecer en 0.

Valor devuelto

La rutina StorPortPoFxActivateComponent devuelve uno de estos códigos de estado:

Código devuelto	Descripción
STOR_STATUS_SUCCESS	La referencia de activación del dispositivo de almacenamiento se incrementó correctamente y el componente está en estado activo.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device es NULL. O bien La dirección apunta a una estructura de direcciones de unidad no válida. O bien No se encuentra el dispositivo de almacenamiento especificado por Address . O bien El dispositivo de almacenamiento no está registrado con el marco de administración de energía (PoFx). O bien El SRB al que apunta Srb no se envía desde Storport. O bien El parámetro Flags es distinto de cero.
STOR_STATUS_INVALID_DEVICE_REQUEST	El adaptador o unidad no admite PoFx.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL irQL actual.
STOR_STATUS_BUSY	La referencia de activación del dispositivo de almacenamiento se incrementó correctamente, pero el componente sigue en estado inactivo.

Comentarios

Actualmente, los dispositivos adaptadores y los dispositivos de unidad tienen un recuento máximo de componentes de 1. El índice de Component siempre debe establecerse en 0.

Cada llamada a StorPortPoFxActivateComponent debe coincidir con una llamada posterior a StorPortPoFxIdleComponent.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en a partir de Windows 8.
Plataforma de destino	Universal
Encabezado	storport.h
Library	Storport.lib
IRQL	IRQL <= DISPATCH_LEVEL

Consulte también

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent