OID_PNP_ENABLE_WAKE_UP
Als Satz gibt die OID_PNP_ENABLE_WAKE_UP OID die Aktivierungsfunktionen an, die ein Miniporttreiber in einem Netzwerkadapter aktivieren soll.
Als Abfrage ruft OID_PNP_ENABLE_WAKE_UP die aktuellen Aktivierungsfunktionen ab, die für einen Netzwerkadapter aktiviert sind.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur ist eine Bitmaske von Flags, die zum Aktivieren einer Kombination von Aktivierungsereignissen verwendet werden kann:
NDIS_PNP_WAKE_UP_MAGIC_PACKET
Gibt bei Festlegung an, dass der Miniporttreiber einen Netzwerkadapter aktivieren soll, um beim Empfang eines Magic-Pakets ein Aktivierungsereignis zu signalisieren. (Ein Magic-Paket ist ein Paket, das 16 zusammenhängende Kopien der Ethernet-Adresse des empfangenden Netzwerkadapters enthält.) Gibt nach dem Löschen an, dass der Miniporttreiber den Netzwerkadapter daran hindern soll, ein solches Aktivierungsereignis zu signalisieren.
NDIS_PNP_WAKE_UP_PATTERN_MATCH
Gibt bei Festlegung an, dass der Miniporttreiber einen Netzwerkadapter aktivieren soll, um ein Aktivierungsereignis beim Empfang eines Pakets zu signalisieren, das ein vom Protokoll mit OID_PNP_ADD_WAKE_UP_PATTERN angegebenes Muster enthält. Gibt nach dem Löschen an, dass der Miniporttreiber den Netzwerkadapter daran hindern soll, ein solches Aktivierungsereignis zu signalisieren.
NDIS_PNP_WAKE_UP_LINK_CHANGE
Reserviert. NDIS ignoriert dieses Flag.
Ein Protokolltreiber verwendet die Aktivierungsfunktionen des Netzwerkadapters in NDIS_BIND_PARAMETERS , um die Aktivierungsfunktionen des zugehörigen Netzwerkadapters zu aktivieren. Ein Protokolltreiber kann diese OID auch abfragen, um zu bestimmen, welche Aktivierungsfunktionen für einen Netzwerkadapter aktiviert sind.
NDIS aktiviert nicht sofort die Aktivierungsfunktionen, die ein Protokolltreiber angibt. Stattdessen verfolgt NDIS die Vom Protokolltreiber aktivierten Aktivierungsfunktionen nach, und kurz bevor der Netzwerkadapter in einen Energiesparzustand überwechselt, sendet NDIS eine OID_PNP_ENABLE_WAKE_UP Set-Anforderung an den Miniporttreiber, um die entsprechenden Weckereignisse zu aktivieren.
Bevor der Netzwerkadapter in einen Energiesparzustand überwechselt (d. h. bevor NDIS dem Miniporttreiber eine OID_PNP_SET_POWER Anforderung sendet), sendet NDIS dem Miniporttreiber eine OID_PNP_ENABLE_WAKE_UP Anforderung, um die entsprechenden Aktivierungsfunktionen zu aktivieren.
Der Miniporttreiber muss die entsprechenden geräteabhängigen Schritte ausführen, um Aktivierungsereignisse auf dem Netzwerkadapter zu aktivieren oder zu deaktivieren.
Der Miniporttreiber sollte die Aktivierungsfunktionen löschen, die NDIS mit OID_PNP_ENABLE_WAKE_UP festgelegt hat, wenn das System fortgesetzt wird. Die Aktivierungsfunktionen sollten nicht über Lebensläufe hinweg beibehalten werden. Wenn Die Aktivierungsfunktionen aktiviert sind, legt NDIS explizit OID_PNP_ENABLE_WAKE_UP fest, bevor der Miniport in den Zustand mit geringer Leistung übergeht.
Ein Zwischentreiber, in dem der obere Rand diese OID-Anforderung empfängt, muss die Anforderung immer an den zugrunde liegenden Miniporttreiber weitergeben, indem die NdisOidRequest - oder NdisCoOidRequest-Funktion aufgerufen wird.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.0 und 6.1. Verwenden Sie für NDIS 6.20 und höher stattdessen OID_PM_PARAMETERS ). |
Header |
Ntddndis.h (include Ndis.h) |