OID_PM_PARAMETERS
Als Abfrage können Protokolltreiber die OID_PM_PARAMETERS OID verwenden, um die Funktionen der Energieverwaltungshardware eines derzeit aktivierten Netzwerkadapters abzufragen. Nach erfolgreicher Rückgabe der OID-Abfrageanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_PM_PARAMETERS-Struktur .
Als Satz können Protokolltreiber die OID_PM_PARAMETERS OID verwenden, um die aktuellen Hardwarefunktionen eines Netzwerkadapters zu aktivieren oder zu deaktivieren. Der Protokolltreiber stellt einen Zeiger auf eine NDIS_PM_PARAMETERS-Struktur im InformationBuffer-Member der NDIS_OID_REQUEST-Struktur bereit.
Bemerkungen
Ab NDIS 6.20 verwenden überlastende Protokoll- und Filtertreiber OID_PM_PARAMETERS, um die Hardwarefunktionen für die Energieverwaltung eines derzeit aktivierten Netzwerkadapters abzufragen und festzulegen.
Wenn ein übersteigender Treiber die OID_PM_PARAMETERS OID abfragt, schließt NDIS die Anforderung ab, ohne sie an den Miniporttreiber weiterzuleiten. NDIS speichert die angeforderten Einstellungen und kombiniert sie mit den Einstellungen anderer solcher Anforderungen. Bevor NDIS den Netzwerkadapter in den Energiesparzustand überwechselt, sendet NDIS eine Setanforderung an den Miniporttreiber, die die kombinierten Einstellungen aller von NDIS gespeicherten Anforderungen enthält.
Die derzeit aktivierten Funktionen können eine Teilmenge der Funktionen sein, die von der Hardware unterstützt werden. Weitere Informationen zu den Funktionen, die die Hardware unterstützt, finden Sie unter OID_PM_HARDWARE_CAPABILITIES.
Hinweis Wenn NDIS das NDIS_PM_SELECTIVE_SUSPEND_ENABLED-Flag im WakeUpFlags-MemberNDIS_PM_PARAMETERS-Struktur festlegt, stellt es die OID-Setanforderung von OID_PM_PARAMETERS direkt an den Miniporttreiber aus. Dadurch kann NDIS die Verarbeitung durch Filtertreiber im Netzwerktreiberstapel umgehen.
NDIS oder der Miniporttreiber gibt einen der folgenden status Codes für die Anforderung zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen.
NDIS_STATUS_PENDING
Die Anforderung steht aus. NDIS übergibt den endgültigen status Code und ergebnisse an den OID-Anforderungsvervollständigungshandler des Aufrufers, nachdem die Anforderung abgeschlossen ist.
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_INVALID_PARAMETER
Fehler bei der Anforderung, weil versucht wurde, eine Funktion zu aktivieren, die vom zugrunde liegenden Netzwerkadapter nicht unterstützt wird.
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. |
Header |
Ntddndis.h (include Ndis.h) |