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)

Confira também

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES