OID_PM_ADD_WOL_PATTERN

Artigo
06/15/2023

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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_PM_WOL_PATTERN .

Comentários

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 ele está em um estado de baixa energia. O adaptador de rede deve gerar um evento de ativação quando recebe 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 eventos 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 miniporta, 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 de processamento de uma notificação de evento NetEventSetPower 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 ULONG 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 o OID_PM_REMOVE_WOL_PATTERN solicitação OID para remover o padrão WOL do adaptador de rede subjacente.

Nota 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 miniporta.

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

O driver de miniporta 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 de 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 adaptador de rede subjacente ou NDIS não pôde 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. SET_INFORMATION. Membro BytesNeeded 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.