OID_PM_PARAMETERS

Como 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 que está habilitado 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 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 de NDIS_PM_PARAMETERS no InformationBuffer membro da estrutura NDIS_OID_REQUEST.

Observações

A partir do NDIS 6.20, os drivers de filtro e protocolos sobressociáveis usam OID_PM_PARAMETERS para consultar e definir os recursos de hardware de gerenciamento de energia de um adaptador de rede atualmente habilitado.

Quando um driver sobreposto consulta o OID OID_PM_PARAMETERS, o NDIS conclui a solicitação sem encaminhá-la para o driver de miniporto. O NDIS armazena as configurações solicitadas e as combina com as configurações de outras solicitações. Antes que o NDIS faça 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 miniporto 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.

Observação Se o NDIS definir o sinalizador NDIS_PM_SELECTIVE_SUSPEND_ENABLED no WakeUpFlags membro da estrutura NDIS_PM_PARAMETERS, ele emitirá a solicitação de conjunto OID de OID_PM_PARAMETERS diretamente para o driver de miniporto. Isso permite que o NDIS ignore o processamento filtrando drivers na pilha de driver de rede.

O NDIS ou o driver de miniporto 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
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 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 de . QUERY_INFORMATION. BytesNeededed membro 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

Consulte também

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES