Función PoFxSetComponentResidency (wdm.h)

  • Artículo

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

Sintaxis

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

Parámetros

[in] Handle

Identificador que representa el registro del dispositivo con el marco de administración de energía (PoFx). El controlador de dispositivo recibió previamente este identificador de la rutina PoFxRegisterDevice .

[in] Component

Índice que identifica el componente. Este parámetro es un índice en la matriz Components de la estructura PO_FX_DEVICE que el controlador de dispositivo usó para registrar el dispositivo con PoFx. Si la matriz Components contiene N elementos, los índices de componente van de 0 a N-1.

[in] Residency

Tiempo estimado de residencia, en unidades de 100 nanosegundos. Este parámetro es una sugerencia 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. Para obtener más información, vea la sección Comentarios.

Valor devuelto

None

Observaciones

El controlador de llamada proporciona un tiempo de residencia estimado que PoFx puede usar como sugerencia para mejorar el rendimiento. PoFx usa esta sugerencia para seleccionar un estado fx de bajo consumo adecuado para un componente que se encuentra en la condición de inactividad.

El controlador de dispositivo puede llamar a PoFxSetComponentResidency cada vez que un cambio en circunstancias requiere un cambio en el tiempo de residencia estimado. Después de cada llamada, el nuevo tiempo de residencia estimado permanece en vigor hasta que el controlador llama a PoFxSetComponentResidency de nuevo para actualizarlo.

Si un componente está en la condición inactiva cuando se llama a PoFxSetComponentResidency, PoFx podría cambiar el estado Fx del componente para dar cabida al nuevo tiempo de residencia estimado especificado por el autor de la llamada.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 8.
Plataforma de destino Universal
Encabezado wdm.h
Library Ntoskrnl.lib
Archivo DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL