OID_PM_CURRENT_CAPABILITIES

Jako dotaz můžou nadměrné ovladače použít identifikátor OID_PM_CURRENT_CAPABILITIES k dotazování aktuálně dostupných možností řízení spotřeby síťového adaptéru. Po úspěšném návratu z požadavku dotazu OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST ukazatel na strukturu NDIS_PM_CAPABILITIES.

Poznámky

NDIS zpracovává dotaz pro ovladače miniportu. Počínaje verzí NDIS 6.20 poskytují ovladače miniportu hardwarové možnosti řízení spotřeby během inicializace. NDIS ale může skrýt některé možnosti z ovladače protokolu. Například NDIS může hlásit různé možnosti, když uživatel zakáže některé nebo všechny možnosti řízení spotřeby.

Mějte na paměti, že aktuální možnosti řízení spotřeby, které NDIS hlásí ovladač protokolu, nemusí být nutně stejné jako hardwarové funkce, které ovladač miniportu oznámil NDIS.

NDIS hlásí možnosti řízení spotřeby základního síťového adaptéru na nadlimitní ovladače protokolu v PowerManagementCapabilitiesEx člen struktury NDIS_BIND_PARAMETERS během operace vazby. Ovladače protokolu proto nemusí dotazovat identifikátor OID.

NDIS vydává informace o stavu NDIS_STATUS_PM_CAPABILITIES_CHANGE, které hlásí změny v možnostech řízení spotřeby, které jsou k dispozici pro nadlimitní ovladače.

Pokud má základní síťový adaptér ovladač NDIS 6.1 nebo starší ovladač miniportu, NDIS přeloží možnosti řízení spotřeby základního síťového adaptéru do struktury NDIS_PM_CAPABILITIES.

NDIS vrátí jeden z následujících stavových kódů pro požadavek:

NDIS_STATUS_SUCCESS
Žádost byla úspěšně dokončena. InformationBuffer odkazuje na strukturu NDIS_PM_CAPABILITIES.

NDIS_STATUS_PENDING
Požadavek čeká na dokončení. NDIS předá konečný stavový kód a výsledky obslužné rutině dokončení požadavku OID volajícího po dokončení požadavku.

NDIS_STATUS_BUFFER_TOO_SHORT
Informační vyrovnávací paměť byla příliš krátká. NDIS nastavil DATA. QUERY_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti.

NDIS_STATUS_FAILURE
Žádost se nezdařila z jiných důvodů než z předchozích důvodů.

Požadavky

Verze	Podporováno v NDIS 6.20 a novějších verzích. Není požadováno pro ovladače miniportu. (Viz oddíl Poznámky.)
Záhlaví	Ntddndis.h (včetně Ndis.h)

Viz také

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE