OID_PM_CURRENT_CAPABILITIES

Som en fråga kan överdrivande drivrutiner använda OID_PM_CURRENT_CAPABILITIES OID för att köra frågor mot de för närvarande tillgängliga energisparfunktionerna i ett nätverkskort. Efter en lyckad retur från OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en NDIS_PM_CAPABILITIES struktur.

Anmärkningar

NDIS hanterar frågan för miniportdrivrutiner. Från och med NDIS 6.20 tillhandahåller miniportdrivrutinerna maskinvarufunktionerna för energisparfunktioner under initieringen. NDIS kan dock dölja vissa funktioner från protokolldrivrutinen. NDIS kan till exempel rapportera olika funktioner när en användare inaktiverar vissa eller alla energisparfunktioner.

Observera att de aktuella energisparfunktionerna som NDIS rapporterar till en protokolldrivrutin inte nödvändigtvis är samma som de maskinvarufunktioner som miniportdrivrutinen rapporterade till NDIS.

NDIS rapporterar energisparfunktionerna i ett underliggande nätverkskort till överliggande protokolldrivrutiner i PowerManagementCapabilitiesEx medlem i NDIS_BIND_PARAMETERS-strukturen under bindningsåtgärden. Därför behöver protokolldrivrutiner inte köra frågor mot OID.

NDIS utfärdar en NDIS_STATUS_PM_CAPABILITIES_CHANGE statusindikator för att rapportera ändringar i energisparfunktioner som är tillgängliga för överdrivande drivrutiner.

Om det underliggande nätverkskortet har en NDIS 6.1 eller äldre miniportdrivrutin översätter NDIS energisparfunktionerna i det underliggande nätverkskortet till en NDIS_PM_CAPABILITIES struktur.

NDIS returnerar någon av följande statuskoder för begäran:

NDIS_STATUS_SUCCESS
Begäran har slutförts. InformationBuffer pekar på en NDIS_PM_CAPABILITIES struktur.

NDIS_STATUS_PENDING
Begäran väntar på att slutföras. NDIS skickar den slutliga statuskoden och resultaten till OID-begärans slutförandehanterare för anroparen när begäran har slutförts.

NDIS_STATUS_BUFFER_TOO_SHORT
Informationsbufferten var för kort. NDIS anger DATA. QUERY_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs.

NDIS_STATUS_FAILURE
Begäran misslyckades av andra orsaker än de föregående orsakerna.

Krav

Version

Stöds i NDIS 6.20 och senare. Begärs inte för miniportdrivrutiner. (Se avsnittet Kommentarer.)

Rubrik

Ntddndis.h (inkludera Ndis.h)

Se även

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE