Freigeben über

Melden von funktionen für selektives Anhalten von NDIS

  • Artikel

Ab NDIS 6.30 müssen Miniporttreiber melden, ob der Treiber die Unterstützung für das selektive Anhalten von NDIS aktiviert hat. Die Unterstützung für das selektive Anhalten von NDIS wird durch die Einstellung des standardisierten INF-Schlüsselwort (keyword) *SelectiveSuspend aktiviert oder deaktiviert. Weitere Informationen zu diesem INF-Schlüsselwort (keyword) finden Sie unter Standardisierte INF-Schlüsselwörter für selektives Anhalten von NDIS.

Wenn NDIS die MiniportInitializeEx-Funktion des Treibers aufruft, meldet der Miniporttreiber seine Unterstützung für die unterstützung für selektives Anhalten von NDIS mit den folgenden Schritten:

  1. Der Treiber initialisiert eine NDIS_PM_CAPABILITIES-Struktur mit den Energieverwaltungsfunktionen der zugrunde liegenden Hardware.

    Wenn der Treiber die Unterstützung für das selektive Anhalten von NDIS aktiviert, müssen die Member der NDIS_PM_CAPABILITIES-Struktur wie folgt festgelegt werden:

    • Der Miniporttreiber muss NDIS_PM_CAPABILITIES_REVISION_2 und NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2 für die Überarbeitung und Länge der NDIS_PM_CAPABILITIES-Struktur innerhalb des Headerelements der Struktur angeben.
    • Wenn die *SelectiveSuspend-Schlüsselwort (keyword) den Wert 1 aufweist, ist die Unterstützung des Miniporttreibers für das selektive Anhalten von NDIS aktiviert. Der Miniporttreiber meldet dies, indem das NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED-Flag im Flags-Element dieser Struktur festgelegt wird.

  2. Nachdem die NDIS_PM_CAPABILITIES-Struktur initialisiert wurde, legt der Miniporttreiber das PowerManagementCapabilitiesEx-Element der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-Struktur so fest, dass er auf die initialisierte NDIS_PM_CAPABILITIES-Struktur verweist. Der Miniporttreiber übergibt einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-Struktur im MiniportAttributes-Parameter , wenn der Treiber die NdisMSetMiniportAttributes-Funktion aufruft .

Die Methode, die von Miniporttreibern verwendet wird, um die Unterstützung status des selektiven Anhaltens von NDIS zu melden, basiert auf der NDIS 6.20-Methode zum Melden von Energieverwaltungsfunktionen. Weitere Informationen zu dieser Methode finden Sie unter Reporting Power Management Capabilities.

Weitere Informationen zum Adapterinitialisierungsprozess finden Sie unter Initialisieren eines Miniportadapters.