Compartilhar via


Palavras-chave INF padronizadas para gerenciamento de energia

As palavras-chave padronizadas de gerenciamento de energia são definidas no arquivo INF (informações de instalação) do driver de dispositivo. O sistema operacional lê essas palavras-chave padronizadas e ajusta os recursos atuais de gerenciamento de energia do dispositivo.

Os drivers de cliente da Network Adapter WDF Class Extension (NetAdapterCx) e os drivers de dispositivo de miniporta NDIS tradicionais usam essas palavras-chave de gerenciamento de energia. No entanto, algumas palavras-chave são usadas exclusivamente por drivers NetAdapterCx, enquanto outras são usadas exclusivamente por drivers NDIS, como as seções a seguir descrevem:

O driver de dispositivo de miniporta NDIS tradicional deve sempre indicar os recursos de gerenciamento de energia de hardware do dispositivo para NDIS na estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

Para obter mais informações sobre palavras-chave INF padronizadas, consulte palavras-chave INF padronizadas para dispositivos de rede.

Palavras-chave de gerenciamento de energia para NetAdapterCx e NDIS

As palavras-chave INF padronizadas a seguir são definidas para habilitar ou desabilitar o suporte para recursos de gerenciamento de energia de adaptadores de rede. Elas são usadas por drivers de cliente NetAdapterCx e drivers de dispositivo de miniporta NDIS tradicionais.

  • *WakeOnPattern: um valor que descreve se o dispositivo deve ser habilitado para ativar o computador quando um pacote de rede corresponde a um padrão especificado.

  • *WakeOnMagicPacket: um valor que descreve se o dispositivo deve ser habilitado para ativar o computador quando o dispositivo recebe um pacote mágico . Um pacote mágico é um pacote que contém 16 cópias contíguas do endereço Ethernet do adaptador de rede receptor.

  • *PMARPOffload: um valor que descreve se o dispositivo deve ser habilitado para descarregar o Protocolo de Resolução de Endereço (ARP) quando o sistema entra em um estado de suspensão.

  • *PMNSOffload: Um valor que descreve se o dispositivo deve ser habilitado para descarregar a solicitação de vizinho (NS) quando o sistema entra em um estado de suspensão.

  • *PMWiFiRekeyOffload: Um valor que descreve se o dispositivo deve ser habilitado para descarregar a rechave temporal do grupo (GTK) para WOL (wake-on-wireless-LAN) quando o computador entra em um estado de suspensão.

  • *EEE: um valor que descreve se o dispositivo deve habilitar a ethernet com eficiência energética do IEEE 802.3az.

As colunas na tabela no final deste artigo descrevem os seguintes atributos para palavras-chave de enumeração:

  • SubkeyName: o nome da palavra-chave que você deve especificar no arquivo INF e que aparece no registro.

  • ParamDesc: o texto de exibição associado ao SubkeyName.

  • Valor: o valor inteiro de enumeração associado a cada opção na lista. Esse valor é armazenado em NDI\params\SubkeyName\Value.

  • EnumDesc: o texto de exibição associado a cada valor que aparece no menu.

A tabela a seguir descreve as possíveis entradas INF para as palavras-chave de gerenciamento de energia usadas pelos drivers NDIS e NetAdapterCx.

SubkeyName ParamDesc Valor EnumDesc
*WakeOnPattern Ativar na correspondência de padrão 0 Desabilitadas
1 (Padrão) Enabled
*WakeOnMagicPacket Ativar no pacote mágico 0 Desabilitadas
1 (Padrão) Enabled
*PMARPOffload Descarregamento de ARP 0 Desabilitadas
1 (Padrão) Enabled
*PMNSOffload Descarregamento de NS 0 Desabilitadas
1 (Padrão) Enabled
*PMWiFiRekeyOffload Descarregamento de rechaveamento Wi-Fi 0 Desabilitadas
1 (Padrão) Enabled
*EEE Ethernet com eficiência energética 0 Desabilitado
1 (Padrão) Enabled

Palavras-chave de gerenciamento de energia exclusivas para NetAdapterCx

A palavra-chave de gerenciamento de energia a seguir é somente para uso do driver de cliente NetAdapterCx.

Além do processo padrão do WDF para dar ao usuário controle sobre o estado de inatividade e de despertar do dispositivo, conforme descrito em User Control of Device Idle and Wake Behavior, o NetAdapterCx também define uma palavra-chave INF padronizada específica para dispositivos de rede, permitindo mais controle.

  • *IdleRestriction: Se um dispositivo de rede tiver recursos de desligamento ocioso e ativado do filtro de pacotes, essa configuração permitirá que o usuário decida quando a desativação do dispositivo ocioso poderá acontecer.

    *IdleRestriction é uma palavra-chave INF padronizada por enumeração. A tabela a seguir descreve as possíveis entradas INF para a palavra-chave *IdleRestriction.

SubkeyName ParamDesc Valor EnumDesc
*IdleRestriction Restrição de desligamento ocioso 0 (Padrão) Nenhuma restrição
1 Somente inativo quando o usuário não estiver presente

Palavras-chave de gerenciamento de energia exclusivas para NDIS

As palavras-chave de gerenciamento de energia a seguir são apenas para uso de driver de miniporta NDIS tradicional. Eles não devem ser usados por drivers de cliente NetAdapterCx.

  • *ModernStandbyWoLMagicPacket: Um valor que descreve se o dispositivo deve ser habilitado para ativar o computador quando o dispositivo recebe um pacote mágico e o sistema está no estado de energia S0ix. Isso não se aplica quando o sistema está no estado de energia S4.

Nota

*ModernStandbyWoLMagicPacket tem suporte no NDIS 6.60 e posterior ou no Windows 10, versão 1607 e posterior.

  • *DeviceSleepOnDisconnect: um valor que descreve se o dispositivo deve ser habilitado para colocar o dispositivo em um estado de baixa potência (estado de suspensão) quando a mídia for desconectada e retornar a um estado de energia total (estado de ativação) quando a mídia estiver conectada novamente.

A tabela a seguir descreve as possíveis entradas INF para as palavras-chave de gerenciamento de energia usadas pelos drivers de miniporta NDIS.

SubkeyName ParamDesc Valor EnumDesc
*ModernStandbyWoLMagicPacket Ativar no pacote mágico quando o sistema está no estado de energia S0ix 0 (Padrão) Desabilitadas
1 Enabled
*DeviceSleepOnDisconnect Modo de descanso do dispositivo ao desconectar 0 Desabilitadas
1 (Padrão) Enabled