Compartilhar via


OID_PNP_ENABLE_WAKE_UP

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

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

O InformationBuffer membro 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 miniporto 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 desmarcado, especifica que o driver de miniporto 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 miniporto 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 desmarcado, especifica que o driver de miniporto 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 no NDIS_BIND_PARAMETERS para habilitar os recursos de ativação do adaptador de rede associado. Um driver de protocolo também pode consultar essa 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 os controles das funcionalidades de ativação habilitadas pelo driver de protocolo 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 miniporto 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 miniportuário uma solicitação de OID_PNP_SET_POWER), o NDIS envia ao driver de miniportuário uma solicitação OID_PNP_ENABLE_WAKE_UP para habilitar os recursos de ativação apropriados.

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

O driver de miniporto 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 miniporto 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çãoNdisOidRequestou NdisCoOidRequest.

Requisitos

Versão

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

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NdisCoOidRequest

NdisOidRequest

OID_PM_PARAMETERS

OID_PNP_ADD_WAKE_UP_PATTERN