OID_PM_WOL_PATTERN_LIST
Als Abfrage können überlastende Treiber die OID_PM_WOL_PATTERN_LIST OID verwenden, um die Wake-on-LAN-Muster aufzulisten, die für einen zugrunde liegenden Netzwerkadapter festgelegt sind. Nach erfolgreicher Rückgabe der Abfrage enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine Liste von NDIS_PM_WOL_PATTERN Strukturen, die die aktuell hinzugefügten WOL-Muster beschreiben.
Bemerkungen
NDIS verarbeitet die Abfrage für Miniporttreiber. NDIS-Treiber können die OID_PM_WOL_PATTERN_LIST OID verwenden, um eine Liste der Aktivierungsmuster in LAN abzurufen, die für einen zugrunde liegenden Netzwerkadapter festgelegt sind.
Für jede NDIS_PM_WOL_PATTERN Struktur in der Liste legt NDIS das NextWoLPatternOffset-Element auf den Offset vom Anfang des OID-Informationspuffers (d. h. den Anfang des Puffers, auf den das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur verweist) auf den Anfang der nächsten NDIS_PM_WOL_PATTERN-Struktur in der Liste fest. Der Offset im NextWoLPatternOffset-Member der letzten Struktur in der Liste ist 0.
Für Offsets in einer anderen NDIS_PM_WOL_PATTERN-Struktur als NextWoLPatternOffset (z. B . NameBufferOffset) stellt NDIS Offsets bereit, die relativ zum Anfang jeder NDIS_PM_WOL_PATTERN-Struktur sind.
Wenn auf dem Netzwerkadapter keine WOL-Muster festgelegt sind, legt NDIS die DATEN fest. QUERY_INFORMATION. BytesWritten-Member der NDIS_OID_REQUEST Struktur auf null und gibt NDIS_STATUS_SUCCESS für die Anforderung zurück. Die Daten innerhalb der DATEN. QUERY_INFORMATION. InformationBuffer-Member wird von NDIS nicht geändert.
NDIS gibt einen der folgenden status-Codes für die Anforderung zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer enthält einen Zeiger auf eine Liste von WOL-Mustern, falls vorhanden.
NDIS_STATUS_PENDING
Die Anforderung steht aus. Der endgültige status Code und die Ergebnisse werden an den OID-Anforderungsabschlusshandler des Aufrufers übergeben.
NDIS_STATUS_BUFFER_TOO_SHORT
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_FAILURE
Die Anforderung ist aus anderen Gründen als den vorherigen Gründen fehlgeschlagen.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.20 und höher. Für Miniporttreiber nicht angefordert. (Siehe Abschnitt Hinweise.) |
Header |
Ntddndis.h (include Ndis.h) |