OID_PM_PARAMETERS
Como uma consulta, os drivers de protocolo podem usar o OID OID_PM_PARAMETERS para consultar os recursos de hardware de gerenciamento de energia de um adaptador de rede habilitado no momento. 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_PARAMETERS .
Como um conjunto, os drivers de protocolo podem usar o OID OID_PM_PARAMETERS para habilitar ou desabilitar os recursos de hardware atuais de um adaptador de rede. O driver de protocolo fornece um ponteiro para uma estrutura NDIS_PM_PARAMETERS no membro InformationBuffer da estrutura NDIS_OID_REQUEST .
Comentários
A partir do NDIS 6.20, drivers de protocolo e filtros sobressociáveis usam OID_PM_PARAMETERS para consultar e definir as funcionalidades de hardware de gerenciamento de energia de um adaptador de rede habilitado no momento.
Quando um driver sobreposto consulta o OID OID_PM_PARAMETERS, o NDIS conclui a solicitação sem encaminhá-la para o driver de miniporte. O NDIS armazena as configurações solicitadas e as combina com as configurações de outras solicitações desse tipo. Antes de o NDIS fazer a transição do adaptador de rede para o estado de baixa potência, o NDIS envia uma solicitação definida para o driver de miniporte que contém as configurações combinadas de todas as solicitações armazenadas pelo NDIS.
Os recursos atualmente habilitados podem ser um subconjunto dos recursos compatíveis com o hardware. Para obter mais informações sobre os recursos compatíveis com o hardware, consulte OID_PM_HARDWARE_CAPABILITIES.
Nota Se o NDIS definir o sinalizador NDIS_PM_SELECTIVE_SUSPEND_ENABLED no membro WakeUpFlags da estrutura NDIS_PM_PARAMETERS , ele emitirá a solicitação de conjunto de OID de OID_PM_PARAMETERS diretamente para o driver de miniporte. Isso permite que o NDIS ignore o processamento por drivers de filtro na pilha do driver de rede.
O NDIS ou o driver de miniporto retorna um dos seguintes códigos status para a solicitação:
NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito.
NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O NDIS passará o código status final e os resultados para o manipulador de conclusão da 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_INVALID_PARAMETER
A solicitação falhou porque tentou habilitar um recurso que o adaptador de rede subjacente não dá suporte.
NDIS_STATUS_FAILURE
A solicitação falhou por motivos diferentes dos motivos anteriores.
Requisitos
Versão |
Com suporte no NDIS 6.20 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |