Compartilhar via


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)