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) |