OID_PNP_QUERY_POWER

Die OID_PNP_QUERY_POWER-OID fordert den Miniporttreiber an, um anzugeben, ob der Netzwerkadapter in den im InformationBuffer angegebenen Zustand mit geringer Leistung übergehen kann. Der Zustand mit geringer Leistung wird als einer der folgenden NDIS_DEVICE_POWER_STATE Werte angegeben:

NdisDeviceStateD1
Dies gibt den Gerätestatus D1 an.

NdisDeviceStateD2
Dadurch wird der Gerätestatus D2 angegeben.

NdisDeviceStateD3
Dadurch wird der Gerätestatus D3 angegeben.

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

Durch die Rückgabe von NDIS_STATUS_SUCCESS zu dieser OID-Anforderung garantiert der Miniporttreiber, dass der Netzwerkadapter beim Empfang einer nachfolgenden OID_PNP_SET_POWER-Anforderung in den angegebenen Gerätestromzustand versetzt wird. Der Miniporttreiber darf in diesem Fall nichts tun, um den Übergang zu gefährden.

Miniporttreiber müssen immer NDIS_STATUS_SUCCESS zu dieser 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 in einem nicht angegebenen Intervall nach der OID_PNP_QUERY_POWER-Anforderung eingehen. Durch den in der OID_PNP_SET_POWER Anforderung angegebenen Gerätestatus D0 wird die OID_PNP_QUERY_POWER Anforderung effektiv abgebrochen.

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

Requirements (Anforderungen)

Version

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

Header

Ntddndis.h (include Ndis.h)