OID_PM_ADD_WOL_PATTERN

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

Comentários

NDIS 6.20 e drivers de protocolo posteriores usam OID_PM_ADD_WOL_PATTERN para adicionar um padrão Wake on LAN (WOL) a um adaptador de rede. A solicitação OID contém o critério que o adaptador de rede deve comparar com 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 corresponde aos critérios de padrão.

Um driver de protocolo pode adicionar padrões WOL depois que ele se liga com êxito a um adaptador de rede subjacente e assim que ele tem 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 outros drivers de protocolo que estão vinculados ao mesmo adaptador de miniporta, depois que o NDIS começar a definir um adaptador de rede para um estado de baixo consumo de energia, 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 uma notificação de evento NetEventSetPower para esse adaptador de rede, o NDIS falhará na solicitação.

Antes de enviar essa solicitação OID para os drivers NDIS subjacentes ou concluir a solicitação para o driver sobreposto, ele define o ULONG PatternId membro da estrutura NDIS_PM_WOL_PATTERN como um valor exclusivo. Drivers de protocolo e 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.

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 status NDIS_STATUS_PM_WOL_PATTERN_REJECTED. O StatusBuffer membro da estrutura NDIS_STATUS_INDICATION contém o identificador de padrão WOL ULONG 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 PatternId membro da estrutura NDIS_PM_WOL_PATTERN contém um identificador de padrão.

NDIS_STATUS_PENDING
O pedido 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
NDIS ou adaptador de rede subjacente 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. NDIS definir o DADOS. SET_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST o tamanho mínimo de buffer necessário.

NDIS_STATUS_NOT_SUPPORTED
O adaptador de rede não suporta o padrão WOL solicitado.

NDIS_STATUS_FAILURE
O pedido foi rejeitado por outros motivos que não os anteriores.

Requerimentos

Ver 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