OID_PM_ADD_WOL_PATTERN

Como um conjunto, os drivers de protocolo NDIS usam o OID OID_PM_ADD_WOL_PATTERN para adicionar um padrão wake-on-LAN de gerenciamento de energia a um adaptador de rede. O InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_PM_WOL_PATTERN.

Observações

Os drivers de protocolo NDIS 6.20 e posteriores usam OID_PM_ADD_WOL_PATTERN para adicionar um padrão WOL (Wake on LAN) a um adaptador de rede. A solicitação OID contém o critério que o adaptador de rede deve comparar com os pacotes de entrada quando estiver em um estado de baixa potência. O adaptador de rede deve gerar um evento de ativação quando receber um pacote que corresponda aos critérios de padrão.

Um driver de protocolo pode adicionar padrões WOL depois de se associar com êxito a um adaptador de rede subjacente e assim que tiver os dados necessários (como o endereço IP da interface) para configurar o padrão WOL. O driver de protocolo também pode adicionar um padrão WOL em resposta a algumas outras notificações de evento de gerenciamento de energia, como a rejeição de um padrão WOL adicionado anteriormente ou um protocolo descarregado.

Para evitar condições de corrida no NDIS e em outros drivers de protocolo associados ao mesmo adaptador de miniporto, depois que o NDIS começar a definir um adaptador de rede para um estado de baixa potência, ele falhará em qualquer tentativa de adicionar um novo padrão de ativação a esse adaptador de rede. Por exemplo, se um driver de protocolo NDIS tentar adicionar um novo padrão WOL no contexto do processamento de um NetEventSetPower notificação de evento para esse adaptador de rede, o NDIS falhará na solicitação.

Antes que o NDIS envie essa solicitação OID para os drivers de NDIS subjacentes ou conclua a solicitação para o driver sobreposto, ele define o membro PatternId da estrutura NDIS_PM_WOL_PATTERN como um valor exclusivo. Os drivers de protocolo e o NDIS usam esse identificador de padrão com a solicitação OID OID_PM_REMOVE_WOL_PATTERN para remover o padrão WOL do adaptador de rede subjacente.

Observação O identificador de padrão é um valor exclusivo para cada um dos padrões definidos em um adaptador de rede. No entanto, o identificador de padrão não é globalmente exclusivo em todos os adaptadores de miniporto.

Se o NDIS ou um adaptador de rede subjacente remover um padrão WOL, ele gerará uma indicação de status NDIS_STATUS_PM_WOL_PATTERN_REJECTED. O membro StatusBuffer da estrutura NDIS_STATUS_INDICATION contém o identificador de padrão WOL ULONG do padrão WOL rejeitado.

O driver de miniporto retorna um dos seguintes códigos de status para a solicitação:

NDIS_STATUS_SUCCESS
O padrão solicitado foi adicionado com êxito. O membro PatternId da estrutura NDIS_PM_WOL_PATTERN contém um identificador de padrão.

NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O NDIS passará o código de status final e os resultados para o manipulador de conclusão da solicitação OID do chamador após a conclusão da solicitação.

NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
A solicitação falhou porque a lista de padrões está cheia e o adaptador de rede não pode adicionar outro padrão.

NDIS_STATUS_RESOURCES
O NDIS ou o adaptador de rede subjacente não puderam adicionar o novo padrão devido à falta de recursos.

NDIS_STATUS_INVALID_PARAMETER
Um ou mais parâmetros na estrutura NDIS_PM_WOL_PATTERN eram inválidos.

NDIS_STATUS_BUFFER_TOO_SHORT
O buffer de informações era muito curto. O NDIS define os dados de . SET_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_NOT_SUPPORTED
O adaptador de rede não dá suporte ao padrão WOL solicitado.

NDIS_STATUS_FAILURE
A solicitação falhou por motivos diferentes dos motivos anteriores.

Requisitos

Consulte também

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

NDIS_STATUS_INDICATION

NDIS_STATUS_PM_WOL_PATTERN_REJECTED

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_ADD_WAKE_UP_PATTERN