OID_PNP_ADD_WAKE_UP_PATTERN
Das OID_PNP_ADD_WAKE_UP_PATTERN OID wird von einem Protokolltreiber an einen Miniporttreiber gesendet, um ein Wake-up-Muster anzugeben. Das Wake-up-Muster wird zusammen mit seiner Maske durch eine NDIS_PM_PACKET_PATTERN Struktur beschrieben.
Ein Protokoll, das das Aktivieren von Mustern für einen Miniporttreiber (siehe OID_PNP_ENABLE_WAKE_UP) ermöglicht, verwendet OID_PNP_ADD_WAKE_UP_PATTERN, um ein Wake-up-Muster anzugeben. Das Wake-Up-Muster kann je nach den Funktionen des Netzwerkadapters im Hostspeicher oder auf dem Netzwerkadapter gespeichert werden.
Das InformationBuffer Mitglied der NDIS_OID_REQUEST-Struktur enthält Folgendes:
Eine NDIS_PM_PACKET_PATTERN Struktur, die Informationen über das Muster und seine 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 unmittelbar der NDIS_PM_PACKET_PATTERN Struktur im InformationBuffer. Weitere Informationen zur Funktionsweise dieser Maske finden Sie in der Netzwerkgeräteklasse Power Management Reference.
Ein Wake-up-Muster, das PatternOffset beginnt, Bytes vom Anfang des InformationBuffer-. Weitere Informationen zu Reaktivierungsmustern finden Sie in der Network Device Class Power Management Reference.
Die Anzahl der Reaktivierungsmuster, 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 vom verfügbaren Speicher im Netzwerkadapter. Wenn ein Miniporttreiber aufgrund unzureichender Ressourcen kein Reaktivierungsmuster 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 NdisRequest oder NdisCoRequestaufgerufen wird.
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. |
Kopfball |
Ntddndis.h (include Ndis.h) |