OID_PNP_CAPABILITIES

Der OID_PNP_CAPABILITIES OID fordert einen Miniporttreiber an, die Wake-up-Funktionen seines Netzwerkadapters zurückzugeben oder einen Zwischentreiber anfordert, die Wake-up-Funktionen des Zwischentreibers zurückzugeben. Die Reaktivierungsfunktionen sind als NDIS_PNP_CAPABILITIES Struktur formatiert, die wie folgt definiert ist:

    typedef struct _NDIS_PNP_CAPABILITIES {
         ULONG Flags;
         NDIS_PM_WAKE_UP_CAPABILITIES WakeUpCapabilities;
    } NDIS_PNP_CAPABILITIES, *PNDIS_PNP_CAPABILITIES;  

Die Elemente dieser Struktur enthalten die folgenden Informationen:

Flags
NDIS_DEVICE_WAKE_UP_ENABLE

NDIS legt dieses Kennzeichen fest, wenn der zugrunde liegende Miniporttreiber eine oder mehrere Wake-up-Funktionen unterstützt. Protokolltreiber können dieses Flag testen, um festzustellen, ob ein zugrunde liegender Miniporttreiber Über Wake-up-Funktionen verfügt. Miniporttreiber sollten nicht auf diese Kennzeichnung zugreifen.

WakeUpCapabilities
Eine NDIS_PM_WAKE_UP_CAPABILITIES Struktur, die die Wake-up-Funktionen des Netzwerkadapters des Miniporttreibers angibt. Die NDIS_PM_WAKE_UP_CAPABILITIES-Struktur wird wie folgt definiert:

typedef struct _NDIS_PM_WAKE_UP_CAPABILITIES {
         NDIS_DEVICE_POWER_STATE MinMagicPacketWakeUp;
         NDIS_DEVICE_POWER_STATE MinPatternWakeUp;
         NDIS_DEVICE_POWER_STATE MinLinkChangeWakeUp;
       } NDIS_PM_WAKE_UP_CAPABILITIES, *PNDIS_PM_WAKE_UP_CAPABILITIES;

Die Elemente dieser Struktur enthalten die folgenden Informationen:

MinMagicPacketWakeUp
Gibt den niedrigsten Betriebszustand des Geräts an, aus dem der Netzwerkadapter des Miniporttreibers ein Wake-up signalisieren kann, wenn ein magisches Paket empfangen wird. (Ein Magisches Paket ist ein Paket, das 16 zusammenhängende Kopien der Ethernet-Adresse des empfangenden Netzwerkadapters enthält.) Der Gerätestromzustand wird als einer der folgenden NDIS_DEVICE_POWER_STATE Werte angegeben:

NdisDeviceStateUnspecified
Der Netzwerkadapter unterstützt keine Magic-Packet-Wake-Ups.

NdisDeviceStateD0
Der Netzwerkadapter kann ein Magic-Packet-Wake-up aus dem Geräte-Energiezustand D0 signalisieren. Da D0 der vollständig unterstützte Zustand ist, führt dies nicht zu einer Aktivierung, kann aber als Laufzeitereignis verwendet werden.

NdisDeviceStateD1
Der Netzwerkadapter kann ein Magic-Packet-Wake-up aus den Geräte-Leistungszuständen D1 und D0 signalisieren.

NdisDeviceStateD2-
Der Netzwerkadapter kann ein Magic-Packet-Wake-up von Gerätezuständen D2, D1 und D0 signalisieren.

NdisDeviceStateD3-
Der Netzwerkadapter kann ein Magic-Packet-Wake-up aus den Geräteleistungszuständen D3, D2, D1 und D0 signalisieren.

MinPatternWakeUp-
Gibt den niedrigsten Gerätestromzustand an, aus dem der Netzwerkadapter des Miniporttreibers ein Wake-Up-Ereignis signalisieren kann, wenn ein Netzwerkframe empfangen wird, der ein vom Protokolltreiber angegebenes Muster enthält. Der Energiezustand wird als einer der folgenden NDIS_DEVICE_POWER_STATE Werte angegeben:

NdisDeviceStateUnspecified
Der Netzwerkadapter unterstützt keine Muster-Match-Wake-Ups.

NdisDeviceStateD0
Der Netzwerkadapter kann eine Muster-Match-Reaktivierung über den Gerätestromzustand D0 signalisieren. Da D0 der vollständig unterstützte Zustand ist, führt dies nicht zu einer Aktivierung, kann aber als Laufzeitereignis verwendet werden.

NdisDeviceStateD1
Der Netzwerkadapter kann eine Muster-Match-Reaktivierung von Gerätestromzuständen D1 und D0 signalisieren.

NdisDeviceStateD2-
Der Netzwerkadapter kann eine Muster-Match-Reaktivierung von Gerätestromzuständen D2, D1 und D0 signalisieren.

NdisDeviceStateD3-
Der Netzwerkadapter kann eine Muster-Match-Reaktivierung von Gerätestromzuständen D3, D2, D1 und D0 signalisieren.

MinLinkChangeWakeUp
Reserviert. NDIS ignoriert dieses Element.

für Miniporttreiber

Nachdem der Miniporttreiber die Initialisierung abgeschlossen hat, können sowohl der Protokolltreiber als auch NDIS den Miniporttreiber mit diesem OID abfragen, um Folgendes zu ermitteln:

• Gibt an, ob der Miniporttreiber PM-fähig ist.

• Die Funktionen des Netzwerkadapters, um Netzwerk-Wake-Up-Ereignisse anzugeben.

Wenn der Miniporttreiber NDIS_STATUS_SUCCESS an eine Abfrage von OID_PNP_CAPABILITIES zurückgibt, betrachtet NDIS den Miniporttreiber als PM-fähig. Wenn der Miniporttreiber NDIS_STATUS_NOT_SUPPORTEDzurückgibt, betrachtet NDIS den Miniporttreiber als legacy-Miniporttreiber, der nicht PM-fähig ist.

Beim Aufrufen von NdisMSetAttributesExkann ein Miniporttreiber, der keine Wake-Up-Funktionen unterstützt, jedoch den Netzwerkadapterstatus über einen Stromstatusübergang hinweg speichern und wiederherstellen kann, das NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND Flag festlegen. Durch Festlegen dieses Kennzeichens wird verhindert, dass NDIS die MiniportHalt Funktion des Treibers aufruft, bevor das System in einen Ruhezustand wechselt. Wenn der Miniporttreiber jedoch als Reaktion auf eine Abfrage OID_PNP_CAPABILITIES NDIS_STATUS_NOT_SUPPORTED zurückgibt, ignoriert NDIS das NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND Flag und hält den Netzwerkadapter an, wenn das System in einen Energiesparmodus wechselt.

Der Netzwerkadapter eines Miniporttreibers kann eine beliebige Kombination von Wake-up-Ereignissen unterstützen, einschließlich von Wake-up-Ereignissen. Ein Miniporttreiber kann die Energieverwaltung weiterhin unterstützen, auch wenn sein Netzwerkadapter keine Wake-up-Ereignisse signalisieren kann. In diesem Fall sind die einzigen Leistungsverwaltungs-OIDs, die der Miniporttreiber zusätzlich zu OID_PNP_CAPABILITIES unterstützt, OID_PNP_QUERY_POWER und OID_PNP_SET_POWER.

Wenn ein Netzwerkadapter eines Miniporttreibers ein bestimmtes Wake-up-Ereignis nicht unterstützt, sollte der Miniporttreiber einen NDIS_DEVICE_POWER_STATE Wert von NdisDeviceStateUnspecified für das Wake-up-Ereignis in der NDIS_PM_WAKE_UP_CAPABILITIES-Struktur angeben.

OID_PNP_CAPABILITIES zeigt nur die Wake-up-Funktionen des Netzwerkadapters eines Miniporttreibers an; diese Funktionen werden nicht aktiviert. OID_PNP_ENABLE_WAKE_UP wird verwendet, um die Wake-Up-Funktionen eines Netzwerkadapters zu aktivieren.

für Zwischentreiber

Wenn der zugrunde liegende Netzwerkadapter PM-fähig ist, sollte der Zwischentreiber NDIS_STATUS_SUCCESS an eine Abfrage von OID_PNP_CAPABILITIES zurückgeben. In der NDIS_PM_WAKE_UP_CAPABILITIES Struktur, die von diesem OID zurückgegeben wird, sollte der Zwischentreiber einen Geräteleistungszustand von NdisDeviceStateUnspecified für jede Wake-up-Funktion angeben ( MinMagicPacketWakeUp oder MinPatternWakeUp). Eine solche Antwort gibt an, dass der Zwischentreiber PM-fähig ist, aber kein physisches Gerät verwaltet.

Wenn der zugrunde liegende Netzwerkadapter nicht PM-fähig ist, sollte der Zwischentreiber NDIS_STATUS_NOT_SUPPORTED an eine Abfrage von OID_PNP_CAPABILITIES zurückgeben.

Hinweis Informationen dazu, wie NDIS 6.20 und höher Miniporttreiber Energieverwaltungsfunktionen melden, finden Sie unter Reporting Power Management Capabilities.

Anforderungen

Siehe auch

NDIS_DEVICE_POWER_STATE

NdisMSetAttributesEx

OID_PM_CURRENT_CAPABILITIES

OID_PNP_ENABLE_WAKE_UP

OID_PNP_QUERY_POWER

OID_PNP_SET_POWER

Reporting Power Management Capabilities