estrutura NDIS_PM_PARAMETERS (ntddndis.h)
A estrutura NDIS_PM_PARAMETERS especifica os recursos atuais ou novos de hardware de gerenciamento de energia habilitados para um adaptador de rede.
Sintaxe
typedef struct _NDIS_PM_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG EnabledWoLPacketPatterns;
ULONG EnabledProtocolOffloads;
ULONG WakeUpFlags;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;
Membros
Header
O tipo, a revisão e o tamanho da estrutura NDIS_PM_PARAMETERS . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .
O driver de miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_PM_PARAMETERS , o driver deve definir o membro Revision de Header para o seguinte valor:
NDIS_PM_PARAMETERS_REVISION_2
Foram adicionadas várias alterações para o NDIS 6.30.
Defina o membro Size como NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2.
NDIS_PM_PARAMETERS_REVISION_1
Versão original do NDIS 6.20.
Defina o membro Size como NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1.
EnabledWoLPacketPatterns
Um valor ULONG que contém um OR bit a bit de sinalizadores que correspondem aos recursos relatados pelo driver de miniport no membro SupportedWoLPacketPatterns da estrutura NDIS_PM_CAPABILITIES . O NDIS usa esses sinalizadores para habilitar os padrões WOL (wake-on-LAN) que um adaptador de rede usa para ativar o computador local de um estado de baixa energia. Para obter mais informações sobre padrões WOL, consulte NDIS_PM_WOL_PATTERN.
Os seguintes sinalizadores são usados:
NDIS_PM_WOL_BITMAP_PATTERN_ENABLED
Se esse sinalizador for definido, o adaptador de rede será habilitado para gerar um evento de ativação quando receber um pacote que corresponda a um padrão de bitmap configurado.
NDIS_PM_WOL_MAGIC_PACKET_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação quando receber um pacote magic WOL. Um pacote mágico contém dentro de sua carga uma cadeia de caracteres de seis bytes com um valor de 0xFF, seguido imediatamente por 16 cópias contíguas do endereço MAC (controle de acesso à mídia) do adaptador de rede receptor.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação quando receber uma mensagem de identificador de solicitação EAPOL.
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação quando receber um pacote TCP SYN IPv4. Hosts remotos enviam pacotes TCP SYN para iniciar uma conexão TCP com o computador local.
NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED
Se esse sinalizador for definido, o adaptador de rede será habilitado para gerar um evento de ativação quando receber um pacote TCP SYN IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Se esse sinalizador for definido, o adaptador de rede deverá tratar como valores curinga quaisquer valores preenchidos por zero ou não especificados para endereços IPv4 e portas TCP/UDP em um padrão WOL. Dessa forma, o valor curinga corresponde a qualquer endereço IPv4 e qualquer valor de porta do pacote de entrada no local especificado pelo padrão WOL.
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação se as seguintes condições de correspondência de padrões forem verdadeiras:
- Qualquer valor do pacote de entrada no local especificado pelo padrão WOL será uma correspondência, se o padrão WOL para esse local contiver um valor curinga.
- Um valor do pacote de entrada no local especificado pelo padrão WOL será uma correspondência se o padrão WOL desse local contiver um valor diferente de zero que seja igual ao valor do pacote.
Observação
Os valores curinga habilitados por esse sinalizador podem incluir endereços de origem e destino IPv4 não especificados, bem como portas de origem e destino não especificadas.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED
Se esse sinalizador for definido, o adaptador de rede deverá tratar como valores curinga quaisquer valores preenchidos por zero ou não especificados para endereços IPv6 e portas TCP/UDP em um padrão WOL. Dessa forma, o valor curinga corresponde a qualquer endereço IPv6 e qualquer valor de porta do pacote de entrada no local especificado pelo padrão WOL.
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação se as seguintes condições de correspondência de padrões forem verdadeiras:
- Qualquer valor do pacote de entrada no local especificado pelo padrão WOL será uma correspondência, se o padrão WOL para esse local contiver um valor curinga.
- Um valor do pacote de entrada no local especificado pelo padrão WOL será uma correspondência se o padrão WOL desse local contiver um valor diferente de zero que seja igual ao valor do pacote.
Observação
Os valores curinga habilitados por esse sinalizador podem incluir endereços de origem e destino IPv6 não especificados, bem como portas de origem e destino não especificadas.
EnabledProtocolOffloads
Um valor ULONG que contém um OR bit a bit de sinalizadores que correspondem aos recursos relatados pelo driver de miniport no membro SupportedProtocolOffloads da estrutura NDIS_PM_CAPABILITIES . O NDIS usa esses sinalizadores para habilitar os recursos de descarregamento de protocolo de baixa potência em um adaptador de rede. Os seguintes sinalizadores são usados:
NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED
Se esse bit for definido, o driver de sobreposição solicitará que o adaptador de rede habilite a funcionalidade de descarregamento do protocolo ARP. Assim que esse descarregamento de protocolo tiver sido configurado por uma solicitação definida de OID_PM_ADD_PROTOCOL_OFFLOAD, o driver deverá permitir que o adaptador de rede responda a pacotes ARP IPv4 enquanto ele estiver em um estado de baixa potência.
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
Se esse bit for definido, o driver sobreposto solicitará que o adaptador de rede habilite a funcionalidade de descarregamento de protocolo NS (Solicitação de Vizinho) IPv6. Assim que esse descarregamento de protocolo tiver sido configurado por uma solicitação definida de OID_PM_ADD_PROTOCOL_OFFLOAD, o driver deverá permitir que o adaptador de rede responda a pacotes NS enquanto ele estiver em um estado de baixa potência.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
Se esse bit for definido, o driver sobressalente solicitará que o adaptador de rede habilite a funcionalidade de descarregamento de protocolo RSN (Rede de Segurança Robusta) do IEEE 802.11i. Assim que esse descarregamento de protocolo tiver sido configurado por uma solicitação definida de OID_PM_ADD_PROTOCOL_OFFLOAD, o driver deverá permitir que o adaptador de rede responda a pacotes de solicitações de nova chave RSN enquanto ele estiver em um estado de baixa energia.
WakeUpFlags
Um valor ULONG que contém um OR bit a bit de NDIS_PM_WAKE_ON_ sinalizadores Xxx . O NDIS usa esses sinalizadores para habilitar recursos de ativação em um adaptador de rede. Esse membro usa os seguintes sinalizadores:
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação quando o estado do link mudar da mídia desconectada para a mídia conectada.
Para obter mais informações sobre essa funcionalidade wol, consulte Baixa energia na desconexão de mídia.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação quando o estado do link mudar da mídia conectada à mídia desconectada.
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação sempre que um dos seguintes eventos ocorrer:
- O adaptador de rede recebe um pacote que corresponde a um filtro de pacote de recebimento. O adaptador é configurado com esses filtros por meio de solicitações de conjunto de OID de OID_GEN_CURRENT_PACKET_FILTER.
- O adaptador de rede detecta outros eventos externos que exigem processamento pela pilha de driver de rede, como quando o estado do link é alterado para desconexão de mídia ou mídia conectada.
Observação
O sinalizador NDIS_PM_SELECTIVE_SUSPEND_ENABLED está disponível no NDIS 6.30 e posterior.
Se esse sinalizador estiver definido, nenhum outro sinalizador de gerenciamento de energia poderá ser definido no membro WakeUpFlags e o membro EnabledWoLPacketPatterns deverá ser definido como zero.
Se o NDIS definir o sinalizador NDIS_PM_SELECTIVE_SUSPEND_ENABLED , ele emitirá a solicitação de conjunto de OID de OID_PM_PARAMETERS diretamente para o driver de miniporto. Isso permite que o NDIS ignore o processamento por drivers de filtro na pilha de drivers de rede.
Para obter mais informações sobre o recurso de gerenciamento de energia de suspensão seletiva, consulte Suspensão seletiva do NDIS.
MediaSpecificWakeUpEvents
Um valor ULONG que contém um OR bit a bit de sinalizadores. Esses sinalizadores especificam os eventos de ativação específicos da mídia aos quais um adaptador de rede dá suporte.
A partir do NDIS 6.30, os seguintes sinalizadores são definidos:
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
Se esse sinalizador for definido, o adaptador de rede 802.11 será habilitado para gerar um evento de ativação quando detectar um SSID (identificador de conjunto de serviços) especificado por meio de um descarregamento de rede (NLO).
Para obter mais informações sobre o NLO, consulte Descarregamento de lista de rede do Wi-Fi.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Se esse sinalizador for definido, o adaptador de rede 802.11 será habilitado para gerar um evento de ativação quando ele desassociar com o AP (ponto de acesso).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Se esse sinalizador for definido, o adaptador de rede 802.11 será habilitado para gerar um evento de ativação quando encontrar um erro durante o handshake gtk (chave transitória) do grupo RSN do IEEE 802.11i com a AP.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Se esse sinalizador for definido, o adaptador de rede 802.11 será habilitado para gerar um evento de ativação quando receber o primeiro quadro do handshake de 4 vias do IEEE 802.11i RSN com o AP. Esse handshake é executado quando o adaptador é autenticado com a AP.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
Se esse sinalizador for definido, o adaptador de rede de banda larga móvel (MB) será habilitado para gerar um evento de ativação quando seu estado de registro para o Serviço MB for alterado.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede MB será habilitado para gerar um evento de ativação quando o Serviço MB precisar ser notificado sobre o recebimento de uma mensagem sms (Serviço de Mensagens Curtas). O adaptador gera esse evento de ativação após a conclusão de uma solicitação de consulta OID_WWAN_SMS_READ emitida anteriormente ou a chegada de uma nova mensagem de classe 0 (flash/alerta) do provedor de rede como uma notificação de evento.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede MB será habilitado para gerar um evento de ativação quando receber uma mensagem de USSD (Dados de Serviço Suplementar Não Estruturados).
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede MB será habilitado para gerar um evento de ativação quando a disponibilidade dos dados do pacote celular for alterada. Esse sinalizador é novo em Windows 10.
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede MB será habilitado para gerar um evento de ativação quando o cartão UICC (SIM) for inserido, removido ou inserir um estado de erro. Esse sinalizador é novo em Windows 10.
Comentários
A estrutura NDIS_PM_PARAMETERS especifica os recursos de hardware de gerenciamento de energia habilitados para o OID OID_PM_PARAMETERS . Quando o OID OID_PM_PARAMETERS é consultado, essa estrutura fornece a configuração atual de gerenciamento de energia. Quando o OID_PM_PARAMETERS OID é definido, essa estrutura especifica uma nova configuração de gerenciamento de energia que o adaptador de rede deve usar.
Um driver sobressoante não deve tentar habilitar recursos que um adaptador de rede não dá suporte. Para habilitar um driver sobressalente para determinar quais recursos um adaptador de rede fornece, o NDIS fornece os recursos no membro PowerManagementCapabilitiesEx da estrutura NDIS_BIND_PARAMETERS .
Observação
Os drivers NDIS 6.20 e posteriores devem usar o membro PowerManagementCapabilitiesEx da estrutura NDIS_BIND_PARAMETERS em vez do membro PowerManagementCapabilities .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.20 e posterior. |
| Cabeçalho | ntddndis.h (include Ntddndis.h) |