OID_PM_CURRENT_CAPABILITIES
Como uma consulta, os drivers overlying podem usar o OID do OID_PM_CURRENT_CAPABILITIES para consultar os recursos de gerenciamento de energia disponíveis no momento de um adaptador de rede. Após um retorno bem-sucedido da solicitação de consulta OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_PM_CAPABILITIES .
Comentários
O NDIS manipula a consulta para drivers de miniporta. A partir do NDIS 6.20, os drivers de miniporto 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 miniporto relatou ao NDIS.
O NDIS relata os recursos de gerenciamento de energia de um adaptador de rede subjacente para drivers de protocolo excessivamente subjacentes no membro PowerManagementCapabilitiesEx da estrutura NDIS_BIND_PARAMETERS durante a operação de associação. Portanto, os drivers de protocolo não precisam consultar o OID.
O NDIS emite uma indicação NDIS_STATUS_PM_CAPABILITIES_CHANGE status para relatar alterações nos recursos de gerenciamento de energia que estão disponíveis para drivers de sobreposição.
Se o adaptador de rede subjacente tiver um driver de miniporta NDIS 6.1 ou mais antigo, o NDIS converterá os recursos de gerenciamento de energia do adaptador de rede subjacente em 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
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_BUFFER_TOO_SHORT
O buffer de informações era muito curto. O NDIS define os DADOS. QUERY_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_FAILURE
A solicitação falhou por motivos diferentes dos motivos anteriores.
Requisitos
Versão |
Com suporte no NDIS 6.20 e posterior. Não solicitado para drivers de miniporta. (Consulte a seção Observações.) |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |