OIDs obrigatórios e opcionais para gerenciamento de energia

  • Artigo

Em um driver de miniporta, o suporte para gerenciamento de energia envolve o suporte para identificadores de objeto (OIDs) de gerenciamento de energia. Para ver uma descrição detalhada de como os drivers de miniporta processam consultas e conjuntos para OIDs, consulte Obtendo e definindo informações de driver de miniporta e suporte do NDIS para WMI.

Há dois níveis de suporte de gerenciamento de energia para drivers de miniporta:

  1. Um driver de miniporta pode dar suporte a um adaptador de rede que faz uma transição entre estados de energia. Esse é o nível mínimo de suporte de gerenciamento de energia. Para obter uma descrição dos estados de energia do dispositivo para adaptadores de rede, consulte Estados de energia do dispositivo para adaptadores de rede.

  2. Um driver de miniporta também pode dar suporte a um ou mais eventos de ativação de rede.

Os drivers de miniporta relatam os recursos de gerenciamento de energia durante a inicialização. Para obter mais informações sobre os recursos de gerenciamento de energia relatados durante a inicialização, consulte NDIS_MINIPORT_ADAPTER_ATTRIBUTES e as estruturas de atributos relacionadas.

Um driver de miniporta deve dar suporte aos seguintes OIDs diretamente ou em atributos para que um adaptador de rede faça uma transição entre estados de energia:

  • OID_PNP_CAPABILITIES

    Os drivers intermediários devem responder a essa consulta OID. O NDIS responde a solicitações de OID_PNP_CAPABILITIES em nome dos adaptadores de rede física. Para obter mais informações sobre como responder a esse OID em um driver intermediário, consulte Manipulando eventos PnP e eventos de gerenciamento de energia em um driver intermediário.

  • OID_PNP_QUERY_POWER

    Esse OID especifica um estado de energia do dispositivo para o qual o adaptador de rede deve se preparar para a transição. Um driver de miniporta sempre deve retornar NDIS_STATUS_SUCCESS em resposta a uma consulta de OID_PNP_QUERY_POWER. Ao retornar NDIS_STATUS_SUCCESS em resposta a essa solicitação de OID, o driver de miniporta garante que fará a transição do adaptador de rede para o estado de energia do dispositivo especificado ao receber uma solicitação de OID_PNP_SET_POWER subsequente. Nesse caso, o driver de miniporta não deve fazer nada para comprometer a transição.

  • OID_PNP_SET_POWER

    Esse OID indica que o adaptador de rede deve fazer a transição para o estado de energia do dispositivo indicado. Um driver de miniporta deve definir o adaptador de rede para o estado especificado antes de o driver retornar NDIS_STATUS_SUCCESS. Um driver de miniporta sempre deve retornar NDIS_STATUS_SUCCESS em resposta a esse OID. Se OID_PNP_SET_POWER definir um adaptador de rede para o estado de energia operacional e o driver de miniporta falhar nesse OID, o NDIS presumirá que o dispositivo está em um estado irrecuperável.

Para dar suporte a eventos de ativação de rede, um driver de miniporta também deve dar suporte ao OID OID_PNP_ENABLE_WAKE_UP. Os drivers de protocolo e o NDIS usam esse OID para habilitar os recursos de ativação de um adaptador de rede. Para obter mais informações, consulte Habilitando eventos de ativação.

Para dar suporte a quadros de ativação de rede (consulte Eventos de ativação de rede), um driver de miniporta também deve dar suporte aos seguintes OIDs relacionados a eventos de ativação:

  • OID_PNP_ADD_WAKE_UP_PATTERN

    Um driver de protocolo usa esse OID para adicionar um padrão de ativação a uma lista mantida pelo adaptador de rede, pelo driver de miniporta ou por ambos.

  • OID_PNP_REMOVE_WAKE_UP_PATTERN

    Um driver de protocolo usa esse OID para excluir um padrão de ativação anteriormente especificado por ele com OID_PNP_ADD_WAKE_UP_PATTERN.

Os drivers de miniporta NDIS que dão suporte a eventos de ativação de rede podem, opcionalmente, dar suporte aos seguintes OIDs estatísticos relacionados a eventos de ativação:

  • OID_PNP_WAKE_UP_ERROR

    Os drivers de protocolo consultam esse OID para determinar o número de ativações falsas sinalizadas pelo adaptador de rede do driver de miniporta.

  • OID_PNP_WAKE_UP_OK

    Os drivers de protocolo consultam esse OID para determinar o número de ativações válidas sinalizadas pelo adaptador de rede do driver de miniporta.