NDIS_PM_PARAMETERS estrutura (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 miniporto deve definir o membro tipo do de cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_PM_PARAMETERS, o driver deve definir o membro de revisão do Header para o seguinte valor:
NDIS_PM_PARAMETERS_REVISION_2
Foram adicionadas várias alterações para o NDIS 6.30.
Defina o membro tamanho como NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2.
NDIS_PM_PARAMETERS_REVISION_1
Versão original do NDIS 6.20.
Defina o membro tamanho como NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1.
EnabledWoLPacketPatterns
Um valor de ULONG que contém um OR bit a bit ou de sinalizadores que correspondem às funcionalidades relatadas pelo driver de miniporto no supportedWoLPacketPatterns membro 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 potência. 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 estiver 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 mágico 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 de 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 SYN TCP 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 estiver definido, o adaptador de rede será habilitado para gerar um evento de ativação quando receber um pacote SYN TCP IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Se esse sinalizador for definido, o adaptador de rede deverá tratar como caractere curinga valores de quaisquer portas TCP/UDP preenchidas por zero ou não especificado, valores 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 desse 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 para esse local contiver um valor diferente de zero que seja igual ao valor do pacote.
Nota
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 caractere curinga valores de quaisquer portas TCP/UDP preenchidas por zero ou não especificado, valores 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 desse 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 para esse local contiver um valor diferente de zero que seja igual ao valor do pacote.
Nota
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 OU bit a bit de sinalizadores que correspondem aos recursos relatados pelo driver de miniporto no supportedProtocolOffloads membro 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 estiver definido, o driver em excesso 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 estiver 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 estiver definido, o driver em excesso 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 potência.
WakeUpFlags
Um valor ULONG que contém um OR bit a bit de sinalizadores de NDIS_PM_WAKE_ON_ xxx. O NDIS usa esses sinalizadores para habilitar recursos de ativação em um adaptador de rede. Este 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 potência 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 ocorrer um dos seguintes eventos:
- 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 do driver de rede, como quando o estado do link é alterado para desconectar mídia ou mídia conectada.
Nota
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 do WakeUpFlags e o membro EnabledWoLPacketPatterns membro 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 filtrando drivers na pilha de driver de rede.
Para obter mais informações sobre o recurso de gerenciamento de energia de suspensão seletiva, consulte NDIS Selective Suspend.
MediaSpecificWakeUpEvents
Um valor de ULONG que contém um OR bit a bit de sinalizadores. Esses sinalizadores especificam os eventos de ativação específicos da mídia compatíveis com um adaptador de rede.
A partir do NDIS 6.30, os seguintes sinalizadores são definidos:
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
Se esse sinalizador estiver 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 NLO (descarregamento de rede).
Para obter mais informações sobre o NLO, consulte Wi-Fide descarregamento de lista de rede.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede 802.11 será habilitado para gerar um evento de ativação quando ele se desassociar com o AP (ponto de acesso).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Se esse sinalizador estiver definido, o adaptador de rede 802.11 será habilitado para gerar um evento de ativação quando encontrar um erro durante o handshake de chave transitória (GTK) do grupo IEEE 802.11i RSN com a AP.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Se esse sinalizador estiver 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 a AP. Esse handshake é executado quando o adaptador é autenticado com a AP.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
Se esse sinalizador estiver 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 Mensagem Curta). 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 USSD (Dados de Serviço Suplementar Não Estruturado).
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 no 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 no Windows 10.
Observações
A estrutura NDIS_PM_PARAMETERS especifica os recursos de hardware de gerenciamento de energia habilitados para o OID do OID_PM_PARAMETERS. Quando o OID_PM_PARAMETERS OID é 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 em excesso não deve tentar habilitar recursos que um adaptador de rede não dá suporte. Para habilitar um driver em excesso para determinar quais recursos um adaptador de rede fornece, o NDIS fornece os recursos no PowerManagementCapabilitiesEx membro da estrutura NDIS_BIND_PARAMETERS.
Nota
Os drivers NDIS 6.20 e posteriores devem usar o membro PowerManagementCapabilitiesEx da estrutura NDIS_BIND_PARAMETERS em vez do membro PowerManagementCapabilities membro.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.20 e posterior. |
| cabeçalho | ntddndis.h (inclua Ntddndis.h) |