OID_PNP_QUERY_POWER
O OID_PNP_QUERY_POWER OID solicita que o driver de miniporte indique se ele pode fazer a transição do adaptador de rede para o estado de baixa potência 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 de dispositivo D1.
NdisDeviceStateD2
Isso especifica um estado de dispositivo D2.
NdisDeviceStateD3
Isso especifica um estado de dispositivo 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 OID_PNP_SET_POWER que especifica um estado de dispositivo D0.
Ao retornar NDIS_STATUS_SUCCESS a essa solicitação OID, o driver de miniporto garante que ele fará a transição do adaptador de rede para o estado de energia do dispositivo especificado após o recebimento de uma solicitação de OID_PNP_SET_POWER subsequente. O driver de miniporta, neste caso, não deve fazer nada para comprometer a transição.
Os drivers de miniporta sempre devem retornar NDIS_STATUS_SUCCESS a essa solicitação OID. Qualquer outro código de retorno é um erro.
Uma solicitação de OID_PNP_QUERY_POWER é sempre seguida por uma solicitação de OID_PNP_SET_POWER. A solicitação 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 D0 especificado na solicitação OID_PNP_SET_POWER cancela efetivamente a solicitação de OID_PNP_QUERY_POWER.
Um driver intermediário sempre deve 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.
Requisitos
Versão |
Com suporte para NDIS 5.1 e NDIS 6.0 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |