OID_PM_CURRENT_CAPABILITIES
Como uma consulta, os drivers sobrepostos podem usar o OID_PM_CURRENT_CAPABILITIES OID para consultar os recursos de gerenciamento de energia atualmente disponíveis de um adaptador de rede. Após um retorno bem-sucedido da solicitação de consulta OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_PM_CAPABILITIES.
Comentários
O NDIS lida com a consulta de drivers de miniporta. A partir do NDIS 6.20, os drivers de miniporta fornecem os recursos de hardware de gerenciamento de energia durante a inicialização. No entanto, o NDIS pode ocultar alguns recursos do driver de protocolo. Por exemplo, o NDIS pode relatar recursos diferentes quando um usuário desabilita alguns ou todos os recursos de gerenciamento de energia.
Observe que os recursos atuais de gerenciamento de energia que o NDIS relata a um driver de protocolo não são necessariamente os mesmos que os recursos de hardware que o driver de miniporta relatou ao NDIS.
O NDIS relata os recursos de gerenciamento de energia de um adaptador de rede subjacente para drivers de protocolo sobrepostos no PowerManagementCapabilitiesEx membro da estrutura NDIS_BIND_PARAMETERS durante a operação de ligação. Portanto, os drivers de protocolo não precisam consultar o OID.
O NDIS emite uma indicação de status NDIS_STATUS_PM_CAPABILITIES_CHANGE para relatar alterações nos recursos de gerenciamento de energia disponíveis para drivers sobrepostos.
Se o adaptador de rede subjacente tiver um driver de miniporta NDIS 6.1 ou mais antigo, o NDIS traduzirá os recursos de gerenciamento de energia do adaptador de rede subjacente para uma estrutura NDIS_PM_CAPABILITIES.
O NDIS retorna um dos seguintes códigos de status para a solicitação:
NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito. O InformationBuffer aponta para uma estrutura NDIS_PM_CAPABILITIES.
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_BUFFER_TOO_SHORT
O buffer de informações era muito curto. NDIS definir o DADOS. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE
O pedido foi rejeitado por outros motivos que não os anteriores.
Requerimentos
Versão |
Suportado no NDIS 6.20 e posterior. Não solicitado para drivers de miniporta. (Ver secção Observações.) |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |