Partilhar via

Recursos de indicação de status do motivo de ativação do relatório

  • Artigo

A partir do NDIS 6.30, o driver de miniporto deve relatar se pode emitir um motivo de ativação do NDIS status indicação (NDIS_STATUS_PM_WAKE_REASON) para relatar eventos de ativação causados por um dos seguintes:

  • O adaptador de rede recebeu um pacote que correspondia a um padrão WOL (wake-on-LAN). Isso inclui o recebimento de um pacote que corresponde a um filtro de recebimento especificado por meio de uma solicitação de conjunto OID (identificador de objeto) de OID_GEN_CURRENT_PACKET_FILTER.

    Nota Para esse tipo de motivo de ativação status indicação, o adaptador de rede deve ser capaz de salvar o pacote recebido. O driver deve retornar o pacote recebido dentro da indicação status.

  • O adaptador de rede detectou um evento específico de mídia, como uma desassociação de um AP (ponto de acesso) 802.11 ou o recebimento de uma mensagem sms (serviço de mensagem curta) de banda larga móvel (MB).

  • O adaptador de rede detectou outro evento habilitado que não é específico para um padrão WOL ou tipo de mídia (evento independente de mídia). Por exemplo, o driver de miniporto emite o NDIS_STATUS_PM_WAKE_REASON status indica se ele habilitou o adaptador de rede para detectar conexão de mídia ou desconexão.

Nota O suporte para o motivo da ativação do NDIS status indicações são opcionais para drivers de miniporta de Banda Larga Móvel (MB).

Quando o NDIS chama a função MiniportInitializeEx do driver, o driver de miniporta relata seu motivo de ativação status funcionalidades de indicação seguindo estas etapas:

  1. O driver de miniporta inicializa uma estrutura NDIS_PM_CAPABILITIES com os recursos de gerenciamento de energia do hardware subjacente.

    Para habilitar o suporte para indicações de status motivo de ativação, o driver de miniporto deve definir os membros da estrutura NDIS_PM_CAPABILITIES da seguinte maneira:

    • O driver de miniporta deve especificar NDIS_PM_CAPABILITIES_REVISION_2 e NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2 para a revisão e o comprimento da estrutura de NDIS_PM_CAPABILITIES dentro do membro Header da estrutura.

    • Se o adaptador de rede puder armazenar o pacote recebido que causou um evento de ativação do sistema, o driver de miniporto definirá o sinalizador NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED dentro do membro Flags dessa estrutura.

      Se esse sinalizador estiver definido, o adaptador de rede deverá ser capaz de salvar o pacote recebido que fez com que o adaptador gerasse um evento de ativação. Além disso, o driver de miniporta deve ser capaz de fazer o seguinte com esse pacote depois que o adaptador de rede faz a transição para um estado de energia total:

    • O driver de miniporta define o membro MaxWoLPacketSaveBuffer com o tamanho máximo, em unidades de bytes, do buffer que contém o pacote WOL que causou um evento de ativação do sistema.

      O valor do membro MaxWoLPacketSaveBuffer deve ser menor ou igual ao tamanho, em bytes, do cabeçalho máximo da MTU (unidade de transmissão) e mac (controle de acesso à mídia) para a mídia de rede. O driver relata o tamanho da MTU por meio de solicitações de consulta OID de OID_GEN_MAXIMUM_FRAME_SIZE.

    • O driver de miniporta define SupportedWakeUpEvents como os eventos de ativação independentes de mídia aos quais o adaptador de rede dá suporte, como gerar um evento de ativação quando o adaptador se conecta ao adaptador de rede.

    • O driver de miniporto define MediaSpecificWakeUpEvents para os eventos de ativação específicos da mídia aos quais o adaptador de rede dá suporte. Esses eventos incluem a geração de um evento de ativação quando o adaptador 802.11 se desassocia com o AP.

  2. O driver de miniporta inicializa uma estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES e define o membroPowerManagementCapabilitiesEx como o endereço da estrutura de NDIS_PM_CAPABILITIES inicializada.

  3. O driver de miniporto chama a função NdisMSetMiniportAttributes para registrar seus recursos de gerenciamento de energia. Quando o driver de miniporto chama essa função, ele define o parâmetro MiniportAttributes como o endereço da estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

O método usado por drivers de miniporto para relatar o motivo da ativação status recursos de indicação se baseia no método NDIS 6.20 para relatar recursos de gerenciamento de energia. Para obter mais informações sobre esse método, consulte Reporting Power Management Capabilities.

Para obter mais informações sobre o processo de inicialização do adaptador, consulte Inicializando um adaptador miniport.

Para obter mais informações sobre como relatar recursos de gerenciamento de energia, consulte Reporting Power Management Capabilities.