Función StorPortPoFxIdleComponent (storport.h)

Artículo
03/05/2024

La rutina StorPortPoFxIdleComponent disminuye el recuento de referencias de activación de un componente especificado de un dispositivo de almacenamiento.

Sintaxis

ULONG StorPortPoFxIdleComponent(
  [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 idling de un componente de adaptador de almacenamiento.

[in, optional] Srb

SRB que desencadena la desactivación del componente. Este parámetro es NULL si el miniporte está identificando internamente un componente de dispositivo.

[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 StorPortPoFxIdleComponent 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 ha reducido correctamente y el componente está inactivo.
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. O bien Se llamó a StorPortPoFxIdleComponent con un componente inactivo y un Srb para el que no se realizó una llamada anterior a StorPortPoFxActivateComponent.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL irQL actual.
STOR_STATUS_BUSY	La referencia activa para el componente de dispositivo se ha reducido, pero el componente sigue activo.

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 StorPortPoFxIdleComponent debe coincidir con una llamada anterior a StorPortPoFxActivateComponent.