Función StorPortSetPowerSettingNotificationGuids (storport.h)

  • Artículo

La rutina StorPortSetPowerSettingNotificationGuids permite que un miniporte reciba notificaciones de configuración de energía. El miniporte registra una matriz de GUID que identifican la configuración de energía para recibir notificaciones de cambio de energía.

Sintaxis

ULONG StorPortSetPowerSettingNotificationGuids(
  [in] PVOID  HwDeviceExtension,
  [in] ULONG  GuidCount,
  [in] LPGUID Guid
);

Parámetros

[in] HwDeviceExtension

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

[in] GuidCount

Número de GUID de la matriz Guid .

[in] Guid

Matriz de GUID de configuración de energía que se van a registrar para la notificación. Un uso típico para registrar estos GUID es para miniportes SATA para recibir notificaciones para los cambios de configuración de AHCI Link Power Management. La configuración de administración de energía de AHCI Link definida por el controlador miniport de Microsoft AHCI StorPort son las siguientes.

Configuración hipm/DIPM (0b2d69d7-a2a1-449c-9680-f91c70521c60)

Configura el modo de administración de energía de vínculo para los dispositivos de almacenamiento y disco conectados al sistema a través de una interfaz de AHCI.

Índice Nombre Descripción
0 Activo No se usa la administración de energía de vínculo.
1 HIPM se usa Host-Initiated Administración de energía (HIPM).
2 HIPM y DIPM Se usan HIPM y Device-Initiated administración de energía (DIPM).
 

Configuración adaptable (dab60367-53fe-4fbc-825e-521d069d2456)

El período de inactividad del vínculo de AHCI antes de que el vínculo se coloque en un estado de sueño cuando hipm o DIPM esté habilitado.

Valor Descripción
0 Valor mínimo en milisegundos (use solo el estado Parcial).
... Cualquier valor intermedio.
300000 Valor máximo en milisegundos (5 minutos).
 

Otros miniportes pueden definir y registrar sus propios GUID de configuración de energía.

Valor devuelto

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

Código devuelto Descripción
STOR_STATUS_INSUFFICIENT_RESOURCES
 Hay recursos insuficientes disponibles para registrarse para recibir notificaciones.
STOR_STATUS_SUCCESS
 Los GUID de notificación se registraron correctamente.

Comentarios

Un miniporte llama a StorPortSetPowerSettingNotificationGuids en su rutina HwStorFindAdapter para registrar los GUID para los que solicita recibir notificaciones.

Cuando se produce un cambio de estado de energía para una notificación registrada, se notifica al miniporte en su rutina HwStorAdapterControl . El tipo de control ScsiPowerSettingNotification se establece en el parámetro ControlType .

La configuración de administración de energía de AHCI Link forma parte del subgrupo Configuración de disco (0012ee47-9041-4b5d-9b77-535fba8b1442) en la configuración de la directiva de energía. Se administran en el alias de configuración de SUB_DISK con powercfg.exe.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en a partir de Windows 8.
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
IRQL Any

Consulte también

HwStorAdapterControl

HwStorFindAdapter