Freigeben über


OID_PNP_QUERY_POWER

Die OID_PNP_QUERY_POWER OID fordert den Miniporttreiber an, um anzugeben, ob er seinen Netzwerkadapter in den Energiesparzustand übertragen kann, der im InformationBuffer-angegeben ist. Der Energiesparzustand wird als einer der folgenden NDIS_DEVICE_POWER_STATE Werte angegeben:

NdisDeviceStateD1
Dadurch wird ein Gerätestatus von D1 angegeben.

NdisDeviceStateD2-
Dadurch wird ein Gerätezustand von D2 angegeben.

NdisDeviceStateD3-
Dadurch wird ein Gerätezustand von D3 angegeben.

Eine OID_PNP_QUERY_POWER Anforderung wird nicht verwendet, um einen Übergang zu einem Gerätestatus von D0 anzufordern. NDIS sendet einfach eine OID_PNP_SET_POWER Anforderung, die den Gerätestatus von D0 angibt.

Durch die Rückgabe NDIS_STATUS_SUCCESS an diese OID-Anforderung garantiert der Miniporttreiber, dass er den Netzwerkadapter an den angegebenen Gerätestromzustand übergibt, wenn eine nachfolgende OID_PNP_SET_POWER Anforderung empfangen wird. Der Miniporttreiber muss in diesem Fall nichts tun, um den Übergang zu gefährden.

Miniporttreiber müssen immer NDIS_STATUS_SUCCESS an diese OID-Anforderung zurückgeben. Jeder andere Rückgabecode ist ein Fehler.

Auf eine OID_PNP_QUERY_POWER Anforderung folgt immer eine OID_PNP_SET_POWER Anforderung. Die OID_PNP_SET_POWER Anforderung kann sofort der OID_PNP_QUERY_POWER Anforderung folgen oder nach der OID_PNP_QUERY_POWER Anforderung zu einem nicht angegebenen Intervall gelangen. Ein gerätespezifischer D0-Zustand, der in der OID_PNP_SET_POWER Anforderung angegeben ist, bricht die OID_PNP_QUERY_POWER Anforderung effektiv ab.

Ein Zwischentreiber muss immer NDIS_STATUS_SUCCESS an eine Abfrage von OID_PNP_QUERY_POWER zurückgeben. Ein Zwischentreiber sollte niemals eine OID_PNP_QUERY_POWER Anforderung an einen zugrunde liegenden Miniporttreiber weitergeben.

Anforderungen

Version

Unterstützt für NDIS 5.1 und NDIS 6.0 und höher.

Kopfball

Ntddndis.h (include Ndis.h)