OID_PM_CURRENT_CAPABILITIES
Als Abfrage können überlastende Treiber die OID_PM_CURRENT_CAPABILITIES OID verwenden, um die derzeit verfügbaren Energieverwaltungsfunktionen eines 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_CAPABILITIES Struktur.
Bemerkungen
NDIS verarbeitet die Abfrage für Miniporttreiber. Ab NDIS 6.20 stellen Miniporttreiber die Hardwarefunktionen der Energieverwaltung während der Initialisierung bereit. NDIS kann jedoch einige Funktionen vor dem Protokolltreiber ausblenden. Beispielsweise kann NDIS verschiedene Funktionen melden, wenn ein Benutzer einige oder alle Energieverwaltungsfunktionen deaktiviert.
Beachten Sie, dass die aktuellen Energieverwaltungsfunktionen, die NDIS an einen Protokolltreiber meldet, nicht unbedingt mit den Hardwarefunktionen übereinstimmen, die der Miniporttreiber an NDIS gemeldet hat.
NDIS meldet die Energieverwaltungsfunktionen eines zugrunde liegenden Netzwerkadapters an überlastende Protokolltreiber im PowerManagementCapabilitiesEx-Member der NDIS_BIND_PARAMETERS-Struktur während des Bindungsvorgangs. Daher müssen Protokolltreiber die OID nicht abfragen.
NDIS gibt einen NDIS_STATUS_PM_CAPABILITIES_CHANGE status Hinweis aus, um Änderungen an den Energieverwaltungsfunktionen zu melden, die für überlastende Treiber verfügbar sind.
Wenn der zugrunde liegende Netzwerkadapter über einen NDIS 6.1- oder älteren Miniporttreiber verfügt, übersetzt NDIS die Energieverwaltungsfunktionen des zugrunde liegenden Netzwerkadapters in eine NDIS_PM_CAPABILITIES-Struktur .
NDIS gibt einen der folgenden status-Codes für die Anforderung zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer verweist auf eine NDIS_PM_CAPABILITIES-Struktur.
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_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) |