Erforderliche und optionale OIDs für die Energieverwaltung

Bei Miniporttreibern gehört die Unterstützung von Objektbezeichnern (Object Identifiers, OIDs) zur Energieverwaltung. Eine detaillierte Beschreibung, wie Miniporttreiber Abfragen verarbeiten und OIDs festlegen, finden Sie unter Abrufen und Festlegen von Miniporttreiberinformationen und NDIS-Unterstützung für WMI.

Die Energieverwaltung wird bei Miniporttreibern auf zwei Ebenen unterstützt:

1. Ein Miniporttreiber kann einen Netzwerkadapter unterstützen, einen Übergang zwischen Stromzuständen vorzunehmen. Dies ist die Mindestebene der Energieverwaltungsunterstützung. Eine Beschreibung der Leistungszustände für Netzwerkadapter finden Sie unter Geräteleistungszustände für Netzwerkadapter.

2. Ein Miniporttreiber kann auch ein oder mehrere Netzwerkreaktivierungsereignisse unterstützen.

Miniporttreiber melden bei der Initialisierung Energieverwaltungsfunktionen. Weitere Informationen zu Energieverwaltungsfunktionen, die bei der Initialisierung gemeldet werden, finden Sie unter NDIS_MINIPORT_ADAPTER_ATTRIBUTES und den zugehörigen Attributstrukturen.

Ein Miniporttreiber muss für den Übergang zwischen Stromzuständen die folgenden OIDs direkt oder in Attributen für einen Netzwerkadapter unterstützen:

• OID_PNP_CAPABILITIES

  Zwischentreiber müssen auf diese OID-Abfrage reagieren. NDIS antwortet für physische Netzwerkadapter auf OID_PNP_CAPABILITIES-Anforderungen. Weitere Informationen zu Reaktionen auf diese OID in einem Zwischentreiber finden Sie unter Behandeln von PnP- und Energieverwaltungsereignissen in einem Zwischentreiber.

• OID_PNP_QUERY_POWER

  Diese OID gibt einen Geräteleistungszustand an, bei dem der Netzwerkadapter einen Übergang vornehmen soll. Ein Miniporttreiber muss immer NDIS_STATUS_SUCCESS als Reaktion auf eine Abfrage von OID_PNP_QUERY_POWER zurückgeben. Durch die Rückgabe von NDIS_STATUS_SUCCESS auf diese OID-Anforderung garantiert der Miniporttreiber, dass er den Netzwerkadapter in den angegebenen Geräteleistungszustand umstellt, wenn eine nachfolgende OID_PNP_SET_POWER-Anforderung eingeht. Der Miniporttreiber darf in diesem Fall den Übergang durch nichts gefährden.

• OID_PNP_SET_POWER

  Diese OID gibt an, dass der Netzwerkadapter in den angegebenen Geräteleistungszustand übergehen muss. Ein Miniporttreiber muss den Netzwerkadapter auf den angegebenen Zustand festlegen, bevor der Treiber NDIS_STATUS_SUCCESS zurückgibt. Ein Miniporttreiber muss als Reaktion auf diese OID immer NDIS_STATUS_SUCCESS zurückgeben. Wenn OID_PNP_SET_POWER einen Netzwerkadapter auf den funktionierenden Leistungszustand festlegt und der Miniporttreiber diese OID nicht erfüllt, geht NDIS davon aus, dass sich das Gerät in einem nicht wiederherstellbaren Zustand befindet.

Zur Unterstützung von Netzwerkaktivierungsereignissen muss ein Miniporttreiber auch die OID_PNP_ENABLE_WAKE_UP-OID unterstützen. Sowohl Protokolltreiber als auch NDIS verwenden diese OID, um die Aktivierungsfunktionen eines Netzwerkadapters zu aktivieren. Weitere Informationen finden Sie unter Aktvieren von Aktivierungsereignissen.

Zur Unterstützung von Netzwerkaktivierungsframes (siehe Netzwerkaktivierungsereignisse), muss ein Miniporttreiber auch die folgenden OIDs unterstützen, die sich auf Aktivierungsereignisse beziehen:

• OID_PNP_ADD_WAKE_UP_PATTERN

  Ein Protokolltreiber verwendet diese OID, um einer vom Netzwerkadapter und/oder Miniporttreiber verwalteten Liste Aktivierungsmusters hinzuzufügen.

• OID_PNP_REMOVE_WAKE_UP_PATTERN

  Ein Protokolltreiber verwendet diese OID, um ein zuvor mit OID_PNP_ADD_WAKE_UP_PATTERN angegebenes Aktivierungsmuster zu löschen.

NDIS-Miniporttreiber, die Netzwerkaktivierungsereignisse unterstützen, können optional die folgenden statistischen OIDs zu Aktivierungsereignissen unterstützen:

• OID_PNP_WAKE_UP_ERROR

  Protokolltreiber fragen dieses OID ab, um die Anzahl der vom Netzwerkadapter des Miniporttreibers signalisierten falschen Aktivierungen zu ermitteln.

• OID_PNP_WAKE_UP_OK

  Protokolltreiber fragen diese OID ab, um die Anzahl der vom Netzwerkadapter des Miniporttreibers signalisierten gültigen Aktivierungen zu ermitteln.