Partilhar via


OID_PNP_QUERY_POWER

O OID_PNP_QUERY_POWER OID solicita que o driver de miniporta indique se ele pode fazer a transição de seu adaptador de rede para o estado de baixo consumo especificado no InformationBuffer. O estado de baixa potência é especificado como um dos seguintes valores de NDIS_DEVICE_POWER_STATE:

NdisDeviceStateD1
Isso especifica um estado do dispositivo de D1.

NdisDeviceStateD2
Isso especifica um estado do dispositivo de D2.

NdisDeviceStateD3
Isso especifica um estado do dispositivo de D3.

Uma solicitação OID_PNP_QUERY_POWER não é usada para solicitar uma transição para um estado de dispositivo D0. O NDIS simplesmente envia uma solicitação de OID_PNP_SET_POWER que especifica um estado do dispositivo de D0.

Ao retornar NDIS_STATUS_SUCCESS a essa solicitação OID, o driver de miniporta garante que fará a transição do adaptador de rede para o estado de energia do dispositivo especificado ao receber uma solicitação de OID_PNP_SET_POWER subsequente. O motorista do miniporto, neste caso, não deve fazer nada para comprometer a transição.

Os drivers de miniporta devem sempre retornar NDIS_STATUS_SUCCESS a essa solicitação OID. Qualquer outro código de retorno é um erro.

Um pedido de OID_PNP_QUERY_POWER é sempre seguido por um pedido de OID_PNP_SET_POWER. A solicitação de OID_PNP_SET_POWER pode seguir imediatamente a solicitação de OID_PNP_QUERY_POWER ou pode chegar a um intervalo não especificado após a solicitação de OID_PNP_QUERY_POWER. Um estado de dispositivo de D0 especificado na solicitação de OID_PNP_SET_POWER cancela efetivamente a solicitação de OID_PNP_QUERY_POWER.

Um driver intermediário deve sempre retornar NDIS_STATUS_SUCCESS a uma consulta de OID_PNP_QUERY_POWER. Um driver intermediário nunca deve propagar uma solicitação de OID_PNP_QUERY_POWER para um driver de miniporta subjacente.

Requerimentos

Versão

Suportado para NDIS 5.1 e NDIS 6.0 e posterior.

Cabeçalho

Ntddndis.h (inclui Ndis.h)