OID_PM_PARAMETERS
Als Abfrage können Protokolltreiber das OID_PM_PARAMETERS OID verwenden, um die Power Management-Hardwarefunktionen eines derzeit aktivierten Netzwerkadapters abzufragen. Nach einer erfolgreichen Rückgabe aus 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 das 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 übermäßig viele Protokoll- und Filtertreiber OID_PM_PARAMETERS, um die Hardwarefunktionen für die Energieverwaltung eines derzeit aktivierten Netzwerkadapters abzufragen und festzulegen.
Wenn ein übermäßiger Treiber den 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 überträgt, sendet NDIS eine set-Anforderung an den Miniporttreiber, der die kombinierten Einstellungen aus allen Von NDIS gespeicherten Anforderungen enthält.
Die derzeit aktivierten Funktionen können eine Teilmenge der von der Hardware unterstützten Funktionen sein. Weitere Informationen zu den von der Hardware unterstützten Funktionen finden Sie unter OID_PM_HARDWARE_CAPABILITIES.
Hinweis Wenn NDIS das NDIS_PM_SELECTIVE_SUSPEND_ENABLED Flag im WakeUpFlags Mitglied der NDIS_PM_PARAMETERS Struktur festlegt, gibt es die OID-Setanforderung von OID_PM_PARAMETERS direkt an den Miniporttreiber aus. Auf diese Weise kann NDIS die Verarbeitung durch Filtertreiber im Netzwerktreiberstapel umgehen.
NDIS oder der Miniporttreiber gibt einen der folgenden Statuscodes 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 Statuscode und ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen ist.
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_INVALID_PARAMETER
Fehler bei der Anforderung, da sie versucht hat, eine Funktion zu aktivieren, die der zugrunde liegende Netzwerkadapter nicht unterstützt.
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. |
Kopfball |
Ntddndis.h (include Ndis.h) |