OID_PM_HARDWARE_CAPABILITIES

Als Abfrage können überlastende Treiber die OID_PM_HARDWARE_CAPABILITIES OID verwenden, um die Hardwarefunktionen der Energieverwaltung 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 im PowerManagementCapabilitiesEx-Member der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-Struktur bereit.

Der Miniporttreiber muss einen NDIS_STATUS_PM_CAPABILITIES_CHANGE status Anzeigen ausstellen, um Änderungen an den Hardwarefunktionen der Energieverwaltung eines Netzwerkadapters an NDIS und überlastende Treiber zu melden.

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)

Weitere Informationen

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE