Recursos de gerenciamento de energia de relatórios

Os drivers de miniport que dão suporte ao NDIS 6.20 e versões posteriores do NDIS relatam seus recursos de gerenciamento de energia de hardware durante a inicialização. O NDIS relata os recursos atuais para substituir os drivers de protocolo NDIS durante a operação de associação. No entanto, o NDIS pode ocultar alguns recursos do driver de protocolo. Por exemplo, o NDIS pode relatar recursos diferentes quando um usuário desabilita alguns ou todos os recursos de gerenciamento de energia.

Observe que os recursos atuais de gerenciamento de energia que o NDIS relata a um driver de protocolo não são necessariamente os mesmos que os recursos de hardware que o driver de miniporto relatou ao NDIS.

Se um driver de miniporta NDIS 6.1 ou anterior estiver associado a um driver de protocolo NDIS 6.20, o NDIS converterá os recursos de gerenciamento de energia em um formato compatível com o driver de protocolo NDIS 6.20. O NDIS também converte os recursos de gerenciamento de energia que um driver de miniporta NDIS 6.20 relata em um formato compatível com o NDIS 6.1 e drivers de sobreposição anteriores.

Os recursos de hardware que um driver de miniporto relata podem ser habilitados ou desabilitados nas configurações de arquivo INF. Para obter mais informações sobre as configurações de arquivo INF de gerenciamento de energia, consulte Palavras-chave INF padronizadas para Gerenciamento de Energia.

Durante a inicialização do miniporto, um driver de miniporto inicializa uma estrutura NDIS_PM_CAPABILITIES com os recursos de gerenciamento de energia do hardware subjacente. O driver de miniporta define o membro PowerManagementCapabilitiesEx da estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES para apontar para a estrutura NDIS_PM_CAPABILITIES .

A estrutura NDIS_PM_CAPABILITIES inclui as seguintes informações:

Sinalizadores
Para o NDIS 6.20, esse membro é reservado para NDIS.

A partir do NDIS 6.30, os seguintes sinalizadores são definidos:

NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
Se esse sinalizador for definido, o adaptador de rede poderá salvar o pacote recebido que fez com que o adaptador gerasse um evento de ativação.

Para obter mais informações sobre esse recurso de gerenciamento de energia, consulte Indicações de status do motivo de ativação do NDIS.

NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
Se esse sinalizador for definido, o driver de miniporto oferecerá suporte à suspensão seletiva do NDIS para adaptadores de rede.

Para obter mais informações sobre essa funcionalidade de gerenciamento de energia, consulte Suspensão seletiva do NDIS.

SupportedWoLPacketPatterns
Contém sinalizadores que especificam os padrões de pacote WOL (wake-on-LAN) aos quais um adaptador de rede dá suporte. Por exemplo, o adaptador de rede pode gerar um evento de ativação quando recebe um bitmap, um pacote magic WOL ou uma mensagem de identificador de solicitação EAPOL (EAP over LAN). Para obter uma lista completa dos padrões com suporte no sistema operacional atual, consulte a página de referência NDIS_PM_CAPABILITIES .

NumTotalWoLPatterns
Um valor ULONG que contém o número total de padrões WOL aos quais um adaptador de rede dá suporte. Essa é a soma de "número de padrões de protocolo WOL com suporte" e "número de padrões de bitmap WOL com suporte".

Por exemplo, se o driver der suporte a 8 padrões de bitmap flexíveis, IPv4 TCP SYN (por meio de filtro predefinido) e pacote mágico, você relatará 9 em NumTotalWoLPatterns. (8 bitmaps + 1 IPv4 TCP SYN = 9)

Nota O número total de padrões WOL não inclui o padrão de ativação de pacote mágico.

Para obter mais informações sobre padrões de protocolo WOL, consulte NDIS_PM_WOL_PATTERN.

MaxWoLPatternSize
Contém o número máximo de bytes que podem ser comparados com um padrão.

MaxWoLPatternOffset
Contém o número de bytes em um pacote que pode ser examinado, que começa desde o início do cabeçalho MAC.

MaxWoLPacketSaveBuffer
Contém o número de bytes de um padrão de protocolo WOL que um driver de miniporto pode salvar em um buffer e indicar a pilha de driver.

SupportedProtocolOffloads
Contém sinalizadores que especificam os recursos de descarregamento do protocolo de gerenciamento de energia aos quais um adaptador de rede dá suporte. Os drivers de miniporta usam esses sinalizadores para relatar os recursos de descarregamento de protocolo de baixa potência de um adaptador de rede. Por exemplo, o adaptador de rede pode dar suporte a descarregamento de ARP IPv4, Solicitação de Vizinho IPv6 (NS) ou RSN (rede segura robusta) IEEE 802.11 e handshake bidirecional. Para obter uma lista completa dos descarregamentos de protocolo com suporte no sistema operacional atual, consulte a página de referência NDIS_PM_CAPABILITIES .

NumArpOffloadIPv4Addresses
Contém o número de endereços IPv4 de descarregamento ARP.

NumNSOffloadIPv6Addresses
Contém o número de solicitações de descarregamento de NS (solicitação de rede) que o adaptador de rede dá suporte.

MinMagicPacketWakeUp
Especifica o estado de energia do dispositivo mais baixo do qual um adaptador de rede pode sinalizar um evento de ativação ao receber 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.)

MinPatternWakeUp
Especifica o estado de energia do dispositivo mais baixo do qual um adaptador de rede pode sinalizar um evento de ativação no recebimento de um quadro de rede que contém um padrão especificado pelo driver de protocolo.

MinLinkChangeWakeUp
Especifica o estado de energia do dispositivo mais baixo do qual um adaptador de rede pode sinalizar um evento de ativação quando há uma alteração de link (conexão de mídia ou desconexão).

SupportedWakeUpEvents
Especifica os eventos de ativação independentes de mídia aos quais um adaptador de rede dá suporte. Esses eventos não são específicos do tipo de mídia. Por exemplo, esses eventos de ativação incluem eventos de alteração de link.

MediaSpecificWakeUpEvents
Especifica os eventos de ativação específicos da mídia aos quais um adaptador de rede dá suporte. Por exemplo, esses eventos incluem o seguinte:

• O adaptador de rede 802.11 desassocia-se com o ponto de acesso (AP).

• O adaptador de rede de banda larga móvel (MB) detecta uma alteração em seu estado de registro para o Serviço MB.

Se um driver de miniporto der suporte ao descarregamento de protocolos para um adaptador de rede em um estado de baixa potência, ele deverá dar suporte ao mesmo estado de baixa energia para o descarregamento de protocolo que ele dá suporte para um evento WOL de correspondência de padrão; ou seja, o valor especificado no membro MinPatternWakeUp ou MinMagicPacketWakeUp .

O NDIS inicializa uma estrutura NDIS_PM_CAPABILITIES com os recursos de gerenciamento de energia disponíveis no momento do adaptador de rede subjacente e passa o protocolo sobre drivers de protocolo durante a operação de associação. O NDIS define o membro PowerManagementCapabilitiesEx da estrutura NDIS_BIND_PARAMETERS para apontar para a estrutura NDIS_PM_CAPABILITIES.

Drivers sobrepostos podem usar a consulta OID OID_PM_HARDWARE_CAPABILITIES para obter os recursos de gerenciamento de energia de hardware do adaptador de rede. O NDIS lida com essa solicitação OID em nome do driver de miniporta. Os drivers de miniporto NDIS não são necessários para dar suporte à solicitação OID OID_PM_HARDWARE_CAPABILITIES.

Os drivers em excesso podem usar o OID do OID_PM_CURRENT_CAPABILITIES para consultar os recursos de gerenciamento de energia disponíveis no momento de um adaptador de rede. O NDIS lida com essa solicitação OID em nome do driver de miniporta. Os drivers de miniporto NDIS não são necessários para dar suporte à solicitação OID OID_PM_CURRENT_CAPABILITIES.