OID_PNP_ENABLE_WAKE_UP

  • Artigo

Como um conjunto, o OID_PNP_ENABLE_WAKE_UP OID especifica os recursos de ativação que um driver de miniporta deve habilitar em um adaptador de rede.

Como uma consulta, OID_PNP_ENABLE_WAKE_UP obtém os recursos de ativação atuais que estão habilitados para um adaptador de rede.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST é uma máscara de bits de sinalizadores que pode ser usada para habilitar uma combinação de eventos de ativação:

NDIS_PNP_WAKE_UP_MAGIC_PACKET
Quando definido, especifica que o driver de miniporta deve habilitar um adaptador de rede para 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.) Quando limpo, especifica que o driver de miniporta deve desabilitar o adaptador de rede de sinalizar tal evento de ativação.

NDIS_PNP_WAKE_UP_PATTERN_MATCH
Quando definido, especifica que o driver de miniporta deve habilitar um adaptador de rede para sinalizar um evento de ativação ao receber um pacote que contém um padrão especificado pelo protocolo com OID_PNP_ADD_WAKE_UP_PATTERN. Quando limpo, especifica que o driver de miniporta deve desabilitar o adaptador de rede de sinalizar tal evento de ativação.

NDIS_PNP_WAKE_UP_LINK_CHANGE
Reservado. O NDIS ignora esse sinalizador.

Um driver de protocolo usa os recursos de ativação do adaptador de rede em NDIS_BIND_PARAMETERS para habilitar os recursos de ativação do adaptador de rede associado. Um driver de protocolo também pode consultar esse OID para determinar quais recursos de ativação estão habilitados para um adaptador de rede.

O NDIS não habilita imediatamente os recursos de ativação especificados por um driver de protocolo. Em vez disso, o NDIS mantém o controle dos recursos de ativação que o driver de protocolo habilitou e, pouco antes de o adaptador de rede fazer a transição para um estado de baixa potência, o NDIS envia uma solicitação OID_PNP_ENABLE_WAKE_UP definida para o driver de miniport para habilitar os eventos de ativação apropriados.

Antes que o adaptador de rede faça a transição para um estado de baixa potência (ou seja, antes que o NDIS envie ao driver de miniporta uma solicitação de OID_PNP_SET_POWER ), o NDIS envia ao driver de miniporta uma solicitação de OID_PNP_ENABLE_WAKE_UP para habilitar os recursos de ativação apropriados.

O driver de miniporta deve seguir as etapas apropriadas dependentes do dispositivo para habilitar ou desabilitar eventos de ativação no adaptador de rede.

O driver de miniporta deve limpar os recursos de ativação definidos pelo NDIS com OID_PNP_ENABLE_WAKE_UP quando o sistema é retomado. Os recursos de ativação não devem ser persistidos entre currículos. Se os recursos de ativação estiverem habilitados, o NDIS definirá explicitamente OID_PNP_ENABLE_WAKE_UP antes que o miniporte faça a transição para o estado de baixa potência.

Um driver intermediário no qual a borda superior recebe essa solicitação OID deve sempre propagar a solicitação para o driver de miniporto subjacente chamando a função NdisOidRequest ou NdisCoOidRequest .

Requisitos

Versão

Com suporte no NDIS 6.0 e 6.1. Para o NDIS 6.20 e posterior, use OID_PM_PARAMETERS em vez disso).

Cabeçalho

 Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NdisCoOidRequest

NdisOidRequest

OID_PM_PARAMETERS

OID_PNP_ADD_WAKE_UP_PATTERN