Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Como uma consulta, os drivers de protocolo podem usar o OID_PM_PARAMETERS OID para consultar os recursos de hardware de gerenciamento de energia de um adaptador de rede que estão habilitados no momento. 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_PARAMETERS.
Como um conjunto, os drivers de protocolo podem usar o OID_PM_PARAMETERS OID para habilitar ou desabilitar os recursos de hardware atuais de um adaptador de rede. O driver de protocolo fornece um ponteiro para uma estrutura de NDIS_PM_PARAMETERS no InformationBuffer membro da estrutura NDIS_OID_REQUEST.
Comentários
A partir do NDIS 6.20, os drivers de protocolo e filtro sobrepostos usam OID_PM_PARAMETERS para consultar e definir os recursos de hardware de gerenciamento de energia de um adaptador de rede que estão habilitados no momento.
Quando um driver sobreposto consulta o OID_PM_PARAMETERS OID, o NDIS conclui a solicitação sem encaminhá-la para o driver de miniporta. O NDIS armazena as configurações solicitadas e as combina com as configurações de outras solicitações desse tipo. Antes do NDIS fazer a transição do adaptador de rede para o estado de baixo consumo de energia, o NDIS envia uma solicitação definida para o driver de miniporta que contém as configurações combinadas de todas as solicitações que o NDIS armazenou.
Os recursos que estão habilitados atualmente podem ser um subconjunto dos recursos suportados pelo hardware. Para obter mais informações sobre os recursos suportados pelo hardware, consulte OID_PM_HARDWARE_CAPABILITIES.
Observação Se o NDIS definir o sinalizador de NDIS_PM_SELECTIVE_SUSPEND_ENABLED no WakeUpFlags membro de NDIS_PM_PARAMETERS estrutura, ele emitirá a solicitação de conjunto OID de OID_PM_PARAMETERS diretamente para o driver de miniporta. Isso permite que o NDIS ignore o processamento por drivers de filtro na pilha de drivers de rede.
O NDIS ou o driver de miniporta retorna um dos seguintes códigos de status para a solicitação:
NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito.
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_INVALID_PARAMETER
A solicitação falhou porque tentou habilitar um recurso que o adaptador de rede subjacente não suporta.
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. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |