OID_PM_CURRENT_CAPABILITIES

Als Abfrage können Überleitungstreiber das OID_PM_CURRENT_CAPABILITIES OID verwenden, um die derzeit verfügbaren Energieverwaltungsfunktionen eines 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_CAPABILITIES Struktur.

Bemerkungen

NDIS behandelt die Abfrage für Miniporttreiber. Ab NDIS 6.20 liefern Miniporttreiber während der Initialisierung die Hardwarefunktionen für die Energieverwaltung. NDIS kann jedoch einige Funktionen vom Protokolltreiber ausblenden. Beispielsweise kann NDIS unterschiedliche Funktionen melden, wenn ein Benutzer einige oder alle Energieverwaltungsfunktionen deaktiviert.

Beachten Sie, dass die aktuellen Leistungsverwaltungsfunktionen, die NDIS an einen Protokolltreiber meldet, nicht unbedingt mit den Hardwarefunktionen identisch sind, die der Miniporttreiber NDIS gemeldet hat.

NDIS meldet die Energieverwaltungsfunktionen eines zugrunde liegenden Netzwerkadapters, um Protokolltreiber im PowerManagementCapabilitiesEx Mitglied der NDIS_BIND_PARAMETERS-Struktur während des Bindungsvorgangs zu übersteigen. Daher müssen Protokolltreiber das OID nicht abfragen.

NDIS gibt eine NDIS_STATUS_PM_CAPABILITIES_CHANGE Statusanzeige aus, um Änderungen der Leistungsverwaltungsfunktionen zu melden, die für übermäßig viele 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 Statuscodes für die Anforderung zurück:

NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- verweist auf eine NDIS_PM_CAPABILITIES Struktur.

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_FAILURE
Die Anforderung ist aus anderen Gründen als den vorherigen Gründen fehlgeschlagen.

Anforderungen

Siehe auch

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE