Función StorPortPoFxSetComponentResidency (storport.h)

La rutina StorPortPoFxSetComponentResidency establece el tiempo estimado durante cuánto tiempo es probable que un componente de dispositivo de almacenamiento permanezca inactivo después de que el componente entre en la condición de inactividad.

Sintaxis

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA). Esta es la extensión de dispositivo que se usa para registrar el dispositivo en una llamada anterior a StorPortInitializePoFxPower.

[in, optional] Address

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

[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] Residency

Tiempo estimado de residencia, en unidades de 100 nanosegundos. Este parámetro es una sugerencia para el marco de administración de energía (PoFx) sobre cuánto tiempo es probable que el componente permanezca inactivo después de una transición de la condición activa a la condición inactiva.

Valor devuelto

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

Código devuelto	Descripción
STOR_STATUS_SUCCESS	La residencia de componentes se ha establecido correctamente.
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 índice de Component especifica un componente mayor que el número de componentes para el dispositivo.
STOR_STATUS_INVALID_DEVICE_REQUEST	El dispositivo de almacenamiento no está registrado con PoFx.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL irQL actual.

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	<= DISPATCH_LEVEL

Consulte también

PoFxSetComponentResidency