OID_PM_PARAMETERS
Ovladače protokolu můžou jako dotaz použít identifikátor OID_PM_PARAMETERS k dotazování hardwarových funkcí řízení spotřeby síťového adaptéru, který je aktuálně povolený. Po úspěšném návratu z požadavku dotazu OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST ukazatel na NDIS_PM_PARAMETERS strukturu.
Ovladače protokolu můžou jako sadu použít identifikátor OID_PM_PARAMETERS k povolení nebo zakázání aktuálních hardwarových funkcí síťového adaptéru. Ovladač protokolu poskytuje ukazatel na NDIS_PM_PARAMETERS strukturu v InformationBuffer člen struktury NDIS_OID_REQUEST.
Poznámky
Počínaje verzí NDIS 6.20 používají nadměrné ovladače protokolů a filtrů OID_PM_PARAMETERS k dotazování a nastavení hardwarových možností řízení spotřeby síťového adaptéru, který je aktuálně povolený.
Když se nadlimitní ovladač dotazuje OID_PM_PARAMETERS identifikátoru OID, rozhraní NDIS požadavek dokončí, aniž by ho předal ovladač miniportu. NDIS ukládá požadovaná nastavení a kombinuje je s nastavením z jiných takových požadavků. Než NDIS přepíná síťový adaptér do nízkého stavu napájení, odešle NDIS sadu požadavků na ovladač miniportu, který obsahuje kombinovaná nastavení ze všech požadavků uložených NDIS.
Aktuálně povolené funkce můžou být podmnožinou možností, které hardware podporuje. Další informace o možnostech, které hardware podporuje, najdete v tématu OID_PM_HARDWARE_CAPABILITIES.
Poznámka Pokud NDIS nastaví příznak NDIS_PM_SELECTIVE_SUSPEND_ENABLED v WakeUpFlags člen struktury NDIS_PM_PARAMETERS, vydá požadavek sady identifikátorů OID_PM_PARAMETERS přímo na ovladač miniportu. To umožňuje NDIS obejít zpracování pomocí ovladačů filtru v zásobníku síťových ovladačů.
Ovladač NDIS nebo miniport vrátí jeden z následujících stavových kódů pro požadavek:
NDIS_STATUS_SUCCESS
Žádost byla úspěšně dokončena.
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_INVALID_PARAMETER
Žádost se nezdařila, protože se pokusila povolit schopnost, kterou základní síťový adaptér nepodporuje.
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. |
Záhlaví |
Ntddndis.h (včetně Ndis.h) |