OID_PM_ADD_WOL_PATTERN

Artikel
06/15/2023

Als Satz verwenden NDIS-Protokolltreiber die OID_PM_ADD_WOL_PATTERN OID, um einem Netzwerkadapter ein Wake-on-LAN-Muster für die Energieverwaltung hinzuzufügen. Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_PM_WOL_PATTERN-Struktur .

Bemerkungen

Protokolltreiber von NDIS 6.20 und höher verwenden OID_PM_ADD_WOL_PATTERN, um einem Netzwerkadapter ein WOL-Muster (Wake on LAN) hinzuzufügen. Die OID-Anforderung enthält das Kriterium, dass der Netzwerkadapter mit eingehenden Paketen vergleichen muss, wenn er sich in einem Energiesparzustand befindet. Der Netzwerkadapter muss ein Aktivierungsereignis generieren, wenn er ein Paket empfängt, das den Musterkriterien entspricht.

Ein Protokolltreiber kann WOL-Muster hinzufügen, nachdem er erfolgreich an einen zugrunde liegenden Netzwerkadapter gebunden wurde und sobald er über die erforderlichen Daten (z. B. die IP-Adresse der Schnittstelle) zum Einrichten des WOL-Musters verfügt. Der Protokolltreiber kann auch ein WOL-Muster als Reaktion auf einige andere Energieverwaltungsereignisbenachrichtigungen hinzufügen, z. B. die Ablehnung eines zuvor hinzugefügten WOL-Musters oder eines ausgeladenen Protokolls.

Um Racebedingungen in NDIS und anderen Protokolltreibern zu vermeiden, die an denselben Miniportadapter gebunden sind, schlägt der Versuch fehl, diesem Netzwerkadapter ein neues Aktivierungsmuster hinzuzufügen, nachdem NDIS gestartet hat, einen Energiesparzustand festzulegen. Wenn beispielsweise ein NDIS-Protokolltreiber versucht, im Kontext der Verarbeitung einer NetEventSetPower-Ereignisbenachrichtigung für diesen Netzwerkadapter ein neues WOL-Muster hinzuzufügen, schlägt NDIS die Anforderung fehl.

Bevor NDIS diese OID-Anforderung an die zugrunde liegenden NDIS-Treiber sendet oder die Anforderung an den übergeordneten Treiber abschließt, wird der ULONG PatternId-Member der NDIS_PM_WOL_PATTERN-Struktur auf einen eindeutigen Wert festgelegt. Protokolltreiber und NDIS verwenden diesen Musterbezeichner mit der OID_PM_REMOVE_WOL_PATTERN OID-Anforderung, um das WOL-Muster aus dem zugrunde liegenden Netzwerkadapter zu entfernen.

Hinweis Der Musterbezeichner ist ein eindeutiger Wert für jedes Muster, das auf einem Netzwerkadapter festgelegt ist. Der Musterbezeichner ist jedoch nicht global für alle Miniportadapter eindeutig.

Wenn NDIS oder ein zugrunde liegender Netzwerkadapter ein WOL-Muster entfernt, wird eine NDIS_STATUS_PM_WOL_PATTERN_REJECTED status Angezeigt. Der StatusBuffer-Member der NDIS_STATUS_INDICATION-Struktur enthält den ULONG WOL-Musterbezeichner des abgelehnten WOL-Musters.

Der Miniporttreiber gibt einen der folgenden status Codes für die Anforderung zurück:

NDIS_STATUS_SUCCESS
Das angeforderte Muster wurde erfolgreich hinzugefügt. Das PatternId-Element der NDIS_PM_WOL_PATTERN-Struktur enthält einen Musterbezeichner.

NDIS_STATUS_PENDING
Die Anforderung steht noch aus. NDIS übergibt den endgültigen status Code und ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen ist.

NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
Die Anforderung ist fehlgeschlagen, da die Musterliste voll ist und der Netzwerkadapter kein anderes Muster hinzufügen kann.

NDIS_STATUS_RESOURCES
NDIS oder der zugrunde liegende Netzwerkadapter konnte das neue Muster aufgrund fehlender Ressourcen nicht hinzufügen.

NDIS_STATUS_INVALID_PARAMETER
Mindestens ein Parameter in der NDIS_PM_WOL_PATTERN-Struktur war ungültig.

NDIS_STATUS_BUFFER_TOO_SHORT
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. SET_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_NOT_SUPPORTED
Der Netzwerkadapter unterstützt das angeforderte WOL-Muster nicht.

NDIS_STATUS_FAILURE
Die Anforderung ist aus anderen Gründen als den oben genannten Gründen fehlgeschlagen.