OID_PNP_ADD_WAKE_UP_PATTERN
Die OID_PNP_ADD_WAKE_UP_PATTERN OID wird von einem Protokolltreiber an einen Miniporttreiber gesendet, um ein Aktivierungsmuster anzugeben. Das Aktivierungsmuster wird zusammen mit seiner Maske durch eine NDIS_PM_PACKET_PATTERN-Struktur beschrieben.
Ein Protokoll, das mustergleiches Reaktivieren für einen Miniporttreiber ermöglicht (siehe OID_PNP_ENABLE_WAKE_UP), verwendet OID_PNP_ADD_WAKE_UP_PATTERN, um ein Aktivierungsmuster anzugeben. Das Aktivierungsmuster kann abhängig von den Funktionen des Netzwerkadapters im Hostspeicher oder auf dem Netzwerkadapter gespeichert werden.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält Folgendes:
Eine NDIS_PM_PACKET_PATTERN Struktur, die Informationen zum Muster und seiner Maske bereitstellt.
Eine Maske, die angibt, welche Bytes eines eingehenden Pakets mit den entsprechenden Bytes im Muster verglichen werden sollen. Die Maske beginnt mit dem ersten Byte des Pakets. Die Maske folgt sofort der NDIS_PM_PACKET_PATTERN-Struktur im InformationBuffer. Weitere Informationen zur Funktionsweise dieser Maske finden Sie in der Referenzspezifikation zur Netzgeräteklasse der Energieverwaltung.
Ein Reaktivierungsmuster, das PatternOffset-Bytes am Anfang des InformationBuffers beginnt. Weitere Informationen zu Aktivierungsmustern finden Sie in der Referenzspezifikation zur Netzgeräteklasse für die Energieverwaltung.
Die Anzahl der Aktivierungsmuster, die der Miniporttreiber von einem Protokoll akzeptieren kann, hängt möglicherweise von der Verfügbarkeit von Ressourcen ab, z. B. vom Hostspeicher, den der Miniporttreiber für solche Muster zugewiesen hat, oder von dem verfügbaren Speicher im Netzwerkadapter. Wenn ein Miniporttreiber aufgrund unzureichender Ressourcen kein Aktivierungsmuster hinzufügen kann, gibt der Miniporttreiber als Reaktion auf OID_PNP_ADD_WAKE_UP_PATTERN NDIS_STATUS_RESOURCES zurück.
Wenn ein Protokolltreiber versucht, ein dupliziertes Muster hinzuzufügen, sollte der Miniporttreiber als Reaktion auf OID_PNP_ADD_WAKE_UP_PATTERN NDIS_STATUS_INVALID_DATA zurückgeben.
Ein Zwischentreiber, in dem der obere Rand diese OID-Anforderung empfängt, muss die Anforderung immer an den zugrunde liegenden Miniporttreiber weitergeben, indem er NdisRequest oder NdisCoRequest aufruft.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.0 und NDIS 6.1. Verwenden Sie für NDIS 6.20 und höher stattdessen OID_PM_ADD_WOL_PATTERN . |
Header |
Ntddndis.h (include Ndis.h) |