OID_PNP_ENABLE_WAKE_UP
Als Satz gibt das OID_PNP_ENABLE_WAKE_UP OID die Wake-up-Funktionen an, die ein Miniporttreiber in einem Netzwerkadapter aktivieren soll.
Als Abfrage ruft OID_PNP_ENABLE_WAKE_UP die aktuellen Reaktivierungsfunktionen ab, die für einen Netzwerkadapter aktiviert sind.
Das InformationBuffer Mitglied der NDIS_OID_REQUEST-Struktur ist eine Bitmaske von Flags, die verwendet werden können, um eine Kombination von Wake-up-Ereignissen zu ermöglichen:
NDIS_PNP_WAKE_UP_MAGIC_PACKET
Wenn festgelegt, gibt an, dass der Miniporttreiber einen Netzwerkadapter aktivieren soll, um ein Wake-up-Ereignis beim Empfang eines Magischen Pakets zu signalisieren. (Ein Magisches Paket ist ein Paket, das 16 zusammenhängende Kopien der Ethernet-Adresse des empfangenden Netzwerkadapters enthält.) Gibt beim Löschen an, dass der Miniporttreiber den Netzwerkadapter von der Signalisierung eines solchen Wake-up-Ereignisses deaktivieren soll.
NDIS_PNP_WAKE_UP_PATTERN_MATCH
Wenn festgelegt, gibt an, dass der Miniporttreiber einen Netzwerkadapter aktivieren soll, um ein Wake-up-Ereignis beim Empfang eines Pakets zu signalisieren, das ein muster enthält, das durch das Protokoll mit OID_PNP_ADD_WAKE_UP_PATTERNangegeben ist. Gibt beim Löschen an, dass der Miniporttreiber den Netzwerkadapter von der Signalisierung eines solchen Wake-up-Ereignisses deaktivieren soll.
NDIS_PNP_WAKE_UP_LINK_CHANGE
Reserviert. NDIS ignoriert dieses Flag.
Ein Protokolltreiber verwendet die Wake-Up-Funktionen des Netzwerkadapters in NDIS_BIND_PARAMETERS, um die Wake-up-Funktionen des zugehörigen Netzwerkadapters zu aktivieren. Ein Protokolltreiber kann diesen OID auch abfragen, um zu bestimmen, welche Wake-up-Funktionen für einen Netzwerkadapter aktiviert sind.
NDIS aktiviert nicht sofort die Wake-up-Funktionen, die ein Protokolltreiber angibt. Stattdessen verfolgt NDIS die Wake-up-Funktionen, die der Protokolltreiber aktiviert hat, und sendet NDIS direkt vor dem Wechsel des Netzwerkadapters zu einem Energiesparzustand eine OID_PNP_ENABLE_WAKE_UP set-Anforderung an den Miniporttreiber, um die entsprechenden Wake-Up-Ereignisse zu aktivieren.
Bevor der Netzwerkadapter in einen Energiesparzustand wechselt (d. h. bevor NDIS den Miniporttreiber an eine OID_PNP_SET_POWER Anforderung sendet), sendet NDIS den Miniporttreiber an eine OID_PNP_ENABLE_WAKE_UP Anforderung, um die entsprechenden Wake-up-Funktionen zu aktivieren.
Der Miniporttreiber muss die entsprechenden geräteabhängigen Schritte ausführen, um Wake-up-Ereignisse auf dem Netzwerkadapter zu aktivieren oder zu deaktivieren.
Der Miniporttreiber sollte die Wake-up-Funktionen löschen, die NDIS mit OID_PNP_ENABLE_WAKE_UP festgelegt hat, wenn das System fortgesetzt wird. Die Reaktivierungsfunktionen sollten nicht über Lebensläufe hinweg beibehalten werden. Wenn wake-up-Funktionen aktiviert sind, legt NDIS explizit OID_PNP_ENABLE_WAKE_UP fest, bevor der Miniport in den Energiesparzustand wechselt.
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.
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). |
Kopfball |
Ntddndis.h (include Ndis.h) |