Palavras-chave INF padronizadas para Gerenciamento de Energia

  • Artigo

As palavras-chave padronizadas do gerenciamento de energia são definidas no arquivo INF 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 NetAdapterCx (Network Adapter WDF Class Extension) e os drivers de dispositivo de miniporto 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 miniporto NDIS tradicional sempre deve indicar os recursos de gerenciamento de energia de hardware do dispositivo para o NDIS na estrutura de 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. Eles são usados por drivers de cliente NetAdapterCx e drivers de dispositivo de miniporto 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ços (ARP) quando o sistema entra em um estado de suspensão.

*PMNSOffload
Um valor que descreve se o dispositivo deve ser habilitado para descarregar 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 o rechaveamento de GTK (chave temporal de grupo) 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 o IEEE 802.3az Energy-Efficient Ethernet.

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

SubkeyName
O nome do palavra-chave que você deve especificar no arquivo INF e que aparece no registro.

Paramdesc
O texto de exibição associado a 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 correspondência de padrão 0 Desabilitado
1 (padrão) habilitado
*WakeOnMagicPacket Ativar no pacote mágico 0 Desabilitado
1 (padrão) habilitado
*PMARPOffload Descarregamento de ARP 0 Desabilitado
1 (padrão) habilitado
*PMNSOffload Descarregamento de NS 0 Desabilitado
1 (padrão) habilitado
*PMWiFiRekeyOffload Descarregamento de rechaveamento de WiFi 0 Desabilitado
1 (padrão) habilitado
*EEE Energy-Efficient Ethernet 0 Desabilitado
1 (padrão) habilitado

Palavras-chave de gerenciamento de energia exclusivas para NetAdapterCx

As palavras-chave de gerenciamento de energia a seguir são apenas para uso do driver cliente NetAdapterCx.

Além do processo padrão do WDF para dar ao usuário controle sobre o comportamento ocioso e de ativação do dispositivo, conforme descrito em Controle de Usuário do Comportamento ocioso e de ativação do dispositivo, o NetAdapterCx também define um dispositivo de rede específico padronizado inf palavra-chave para permitir mais controle.

*IdleRestriction
Se um dispositivo de rede tiver a energia ociosa e ativar os recursos de filtro de pacote, essa configuração permitirá que o usuário decida quando a energia ociosa do dispositivo pode acontecer.

*IdleRestriction é uma enumeração padronizada palavra-chave INF e tem os seguintes atributos:

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) Sem restrição
1 Somente ocioso 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 miniporto 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 paket mágico e o sistema está no estado de energia do S0ix . Isso não se aplica quando o sistema está no estado de energia S4 .

Observação

*ModernStandbyWoLMagicPacket tem suporte no NDIS 6.60 e posterior, ou 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 miniporto NDIS.

SubkeyName Paramdesc Valor EnumDesc
*ModernStandbyWoLMagicPacket Ativar pacote mágico quando o sistema estiver no estado de energia do S0ix 0 (padrão) Desabilitado
1 habilitado
*DeviceSleepOnDisconnect Suspensão do dispositivo ao desconectar 0 Desabilitado
1 (Padrão) habilitado