Função StorPortSetPowerSettingNotificationGuids (storport.h)
A rotina StorPortSetPowerSettingNotificationGuids permite que um miniporto receba notificações de configuração de energia. O miniporto registra uma matriz de GUIDs que identificam as configurações de energia para as quais receber notificações de alteração de energia.
Sintaxe
ULONG StorPortSetPowerSettingNotificationGuids(
[in] PVOID HwDeviceExtension,
[in] ULONG GuidCount,
[in] LPGUID Guid
);
Parâmetros
[in] HwDeviceExtension
Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).
[in] GuidCount
O número de GUIDs na matriz de guid do.
[in] Guid
Uma matriz de GUIDs de configuração de energia a ser registrada para notificação. Um uso típico para registrar esses GUIDs é que os miniportos SATA recebam notificações para alterações de configuração do AHCI Link Power Management. As configurações de Gerenciamento de Energia de Link AHCI definidas pelo driver de miniporto Microsoft AHCI StorPort são as seguintes.
Configuração de HIPM/DIPM (0b2d69d7-a2a1-449c-9680-f91c70521c60)
Configura o modo de gerenciamento de energia de link para dispositivos de disco e armazenamento anexados ao sistema por meio de uma interface AHCI.
| Índice | Nome | Descrição |
|---|---|---|
| 0 | Ativo | O gerenciamento de energia de link não é usado. |
| 1 | HIPM | Host-Initiated HIPM (Power Management) é usado. |
| 2 | HIPM e DIPM | HIPM e Device-Initiated POWER Management (DIPM) são usados. |
Configuração adaptável (dab60367-53fe-4fbc-825e-521d069d2456)
O período de tempo ocioso do link AHCI antes que o link seja colocado em um estado de sono quando HIPM ou DIPM estiver habilitado.
| Valor | Descrição |
|---|---|
| 0 | Valor mínimo em milissegundos (use apenas o estado parcial). |
| ... | Qualquer valor intermediário. |
| 300000 | Valor máximo em milissegundos (5 minutos). |
Outros miniportos podem definir e registrar seus próprios GUIDs de configuração de energia.
Valor de retorno
A rotina StorPortSetPowerSettingNotificationGuids retorna um destes códigos de status:
| Código de retorno | Descrição |
|---|---|
|
Recursos insuficientes estão disponíveis para se registrar para notificações. |
|
Os GUIDs de notificação foram registrados com êxito. |
Observações
Um miniporto chama StorPortSetPowerSettingNotificationGuids em seu rotina de HwStorFindAdapter para registrar os GUIDs que ele solicita para receber notificações.
Quando ocorre uma alteração de estado de energia para uma notificação registrada, o miniporto é notificado em seu rotina de HwStorAdapterControl. O tipo de controle ScsiPowerSettingNotification é definido no parâmetro ControlType.
As configurações de gerenciamento do AHCI Link Power fazem parte do subgrupo Configurações de Disco (0012ee47-9041-4b5d-9b77-535fba8b1442) na configuração da política de energia. Eles são gerenciados sob o alias de configuração SUB_DISK com powercfg.exe.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível para começar com o Windows 8. |
| da Plataforma de Destino | Universal |
| cabeçalho | storport.h (inclua Storport.h) |
| IRQL | Qualquer |