OID_PM_WOL_PATTERN_LIST
Als Abfrage können Überleitungstreiber die OID_PM_WOL_PATTERN_LIST OID verwenden, um die Aktivierung von LAN-Mustern aufzulisten, die auf einem zugrunde liegenden Netzwerkadapter festgelegt sind. Nach einer erfolgreichen Rückgabe aus der Abfrage enthält das InformationBuffer- Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine Liste NDIS_PM_WOL_PATTERN Strukturen, die die aktuell hinzugefügten WOL-Muster beschreiben.
Bemerkungen
NDIS behandelt die Abfrage für Miniporttreiber. NDIS-Treiber können die OID_PM_WOL_PATTERN_LIST OID verwenden, um eine Liste der Wake-On-LAN-Muster abzurufen, die auf einem zugrunde liegenden Netzwerkadapter festgelegt sind.
Für jede NDIS_PM_WOL_PATTERN Struktur in der Liste legt NDIS den NextWoLPatternOffset Element auf den Offset vom Anfang des OID-Informationspuffers fest (d. h. den Anfang des Puffers, auf den der InformationBuffer Member der NDIS_OID_REQUEST Struktur verweist) auf den Anfang der nächsten NDIS_PM_WOL_PATTERN Struktur in der Liste. Der Offset im NextWoLPatternOffset Element der letzten Struktur in der Liste ist Null.
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 liegen.
Wenn keine WOL-Muster vorhanden sind, die auf dem Netzwerkadapter festgelegt sind, legt NDIS die DATA 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 DATA. QUERY_INFORMATION. InformationBuffer Mitglied wird von NDIS nicht geändert.
NDIS gibt einen der folgenden Statuscodes für die Anforderung zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- enthält ggf. einen Zeiger auf eine Liste der WOL-Muster.
NDIS_STATUS_PENDING
Die Anforderung steht aus. Der endgültige Statuscode und die Ergebnisse werden an den OID-Anforderungsabschlusshandler des Aufrufers übergeben.
NDIS_STATUS_BUFFER_TOO_SHORT
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. QUERY_INFORMATION. BytesNeeded 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.
Anforderungen
Version |
Unterstützt in NDIS 6.20 und höher. Für Miniporttreiber nicht angefordert. (Siehe Abschnitt "Hinweise".) |
Kopfball |
Ntddndis.h (include Ndis.h) |